対応している B2B タスクのインターフェース、必須パラメータ、レスポンス構造、curl の例、課金の挙動、ポーリング、Webhook 配信フローをまとめて確認できます。
認証
すべての B2B ルートは X-API-Key ヘッダーを使用します。これらのルートに Firebase の Web トークンは不要です。
課金
billing_account_id を持つ従来のキーは、その専用クレジットアカウントを使用します。新しいユーザー単位のキーは、ユーザーのクレジット残高から凍結します。
レスポンス構造
業務レスポンスは code / message / data の形式です。業務エラーでも HTTP 200 が返ることがあります。
タスク作成、クレジット凍結、ポーリング、結果取得、Webhook コールバックがどうつながるか。
パートナー側が X-API-Key とタスクパラメータを B2B の作成エンドポイントへ送信します。
バックエンドが API キーを検証し、所有ユーザーと（任意の）課金アカウントを紐づけます。
ワーカーがコストを算出し、専用アカウントまたはユーザーのクレジット残高から凍結します。
選択されたワーカーが内部または外部の生成機能を呼び出し、タスクの出力を保存します。
パートナー側が /tasks/get または /tasks/get_result を、完了または失敗までポーリングします。
webhook_url に対応していて指定がある場合、バックエンドが最終的なタスクペイロードを POST し、クレジットを精算します。
X-API-Key: ak_xxx{
"code": 0,
"message": "Success",
"data": {
"task_id": "00000000-0000-0000-0000-000000000000",
"status": "PENDING",
"queue_position": 2,
"generation_params": {
"prompt": "anime engineer debugging an API dashboard",
"watermark": false
}
}
}{
"code": 0,
"message": "Success",
"data": {
"task_id": "00000000-0000-0000-0000-000000000000",
"task_type": "API_TEXT_TO_IMAGE_GPT_IMAGE_2",
"status": "COMPLETED",
"result": {
"images": [
{
"display_url": "https://cdn.kusa.pics/generated/example.png",
"width": 1024,
"height": 1024,
"index": 0
}
],
"image_count": 1
}
}
}{
"code": 0,
"data": {
"task_id": "00000000-0000-0000-0000-000000000000",
"status": "COMPLETED",
"result": {
"images": [
{
"display_url": "https://cdn.kusa.pics/generated/example.png",
"width": 1024,
"height": 1024,
"index": 0
}
]
}
}
}0成功
リクエストが受理された、またはデータが正常に返却されました。
40000パラメータ不正
JSON ボディ、タスクパラメータ、ファイル、URL のいずれかが不正です。
40100認証エラー
認証情報がない、または無効です。
42002残高不足
API キーまたはユーザーに、タスクコストを凍結するだけの利用可能クレジットがありません。