画像生成

POST /v1/images/generations はタスクではなく 1 回のレスポンスで答えます。必須は modelprompt で、nsizequality は任意です(省略時は各モデルの既定値)。返るのは {"created": …, "data": [ … ]} で、各要素は url を持ちます。b64_json は存在しますが、"response_format": "b64_json" で要求しない限り空です。既存画像の編集は POST /v1/images/edits に元画像を image で渡します。課金は生成画像 1 枚単位なので、n はそのまま料金の倍率になります。

POST /v1/images/generations
curl https://api.chinaapi.ai/v1/images/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "a red paper crane on a white desk, soft daylight",
    "n": 1
  }'

# {"created":1786620000,
#  "data":[{"url":"https://.../image_inference_output/....jpg","b64_json":""}],
#  "metadata":{"success_count":"1","failed_count":"0"}}
4K 出力

doubao-seedream-5-0-260128

doubao-seedream-4-5-251128 も同じです。どちらも 4K まで対応し、編集や複数画像の合成のために入力画像を受け取れるので、size は既定値任せにせず明示する価値があります。

汎用

wan2.7-image

wan2.7-image-pro も同じで、こちらは約 2 倍の価格で 4K 段階が加わります。リクエストのフィールドはこのエンドポイントの他モデルと同じで、印刷や拡大を前提とする出力なら pro を選んでください。

編集と低コスト

step-image-edit-2

step-2x-largeimage-01 も同じです。step-image-edit-2 は渡した画像の編集に向いた最も安価な 1 つで、image-01 はこのエンドポイントで最も安価なテキストから画像のモデルです。

ヒント このエンドポイントはトークンではなく呼び出し単位で課金し、その価格に画像 1 枚が含まれます。利用ログにはプロンプトトークンが 1 と記録されますが、これは帳簿上の値でありプロンプトの長さを表しません。"n": 4 は画像 1 枚の 4 倍の料金です。ここに並ぶモデルは価格が 1 桁以上違うので、プロンプトを調整する前にモデルを選んでください。