本文へスキップ

開発者向け用語集

接続する前に、API の用語を理解する。

モデル選び、タスク状態の処理、コールバックの検証、利用量の見積り、ユーザー素材の保護に役立つ実務的な定義です。

01

非同期生成 API

定義

メディア要求を受けて永続 taskId を返し、元の HTTP 要求終了後も処理を続ける API。

実装メモ

ポーリングや Webhook 待機の前に taskId を保存します。queued と running は処理中、succeeded・failed・expired は終端です。受理済みタスクはキャンセルできません。

関連ページ →
02

冪等性キー

定義

再送を一つの論理タスクへ結び付け、重複した課金処理を防ぐクライアント生成 ID。

実装メモ

同じ検証済み要求にだけ同じキーを使い、タスクと共に保存して再試行時は元の結果を返します。

関連ページ →
03

Webhook 署名

定義

コールバックが API 由来で改ざんされていないことを受信側が確認する暗号値。

実装メモ

生の本文で検証し、古い時刻を拒否し、状態や請求を変える前に eventId を重複排除します。

関連ページ →
04

モデルスキーマ

定義

モデルの入力項目、型、制限、既定値、出力形式を記述する機械可読の仕様です。

実装メモ

公開スキーマからフォームとサーバー検証を作り、各タスクで使った版を記録します。

関連ページ →
05

参照画像

定義

画像・動画生成で人物、構図、スタイル、動きを誘導する入力画像。

実装メモ

出所と同意を記録し形式を検証します。参照画像は実在人物を複製する許可ではありません。

関連ページ →
06

従量課金

定義

実際の利用量に応じて料金を計算する方式です。モデルごとに、画像 1 枚、出力 1 秒、メガピクセル、トークン、リクエストなどの単位が示されます。

実装メモ

送信前に適用単位と実行前の費用目安を表示します。最低料金、尺、出力数で最終額は変わります。

関連ページ →
07

コンテンツフィルターを抑えた AI モデル

定義

フィルターを抑えた個別モデルの選択肢です。この表示は製品情報であり、プラットフォームの承認ではありません。

実装メモ

送信前に、利用者とサービスに必要な年齢、同意、実在人物、法域の管理を自分のアプリで実装します。

関連ページ →

モデルを接続しますか?

入力項目、作例、現在の料金を確認し、実際の設定で実行前の費用目安を確かめてください。