メインコンテンツへスキップ
POST
/
v1
/
tasks
curl --request POST \
  --url https://qingbo.dev/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡，数字艺术风格",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://example.com/reference.png"
    ]
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
非同期処理モード： リクエスト送信後にタスク ID が返されます。タスクステータス照会 インターフェースで生成結果を取得してください。生成された画像リンクの有効期限は24時間です。速やかに保存してください。
curl --request POST \
  --url https://qingbo.dev/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "prompt": "星空下的古老城堡，数字艺术风格",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://example.com/reference.png"
    ]
  }'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}

​
認証方式

​
Authorization
string
必須
全てのインターフェースで Bearer Token 認証が必要ですAPI Key の取得：API Key 管理ページ にアクセスして API Key を取得してくださいリクエストヘッダーに以下を追加してください：
Authorization: Bearer YOUR_API_KEY

​
リクエストパラメータ

​
model
string
デフォルト:"gpt-4o-image"
必須
画像生成モデル名例："gpt-4o-image"
​
prompt
string
必須
画像生成のテキスト説明最大1000文字
​
size
string
画像生成サイズ対応するアスペクト比：
  • 1:1 - 正方形
  • 2:3 - 縦型
  • 3:2 - 横型
​
n
integer
生成する画像の数1、2、4 に対応、料金は数量に応じて先払いされますデフォルト値：1注意： 数値（例：1）を直接入力してください。引用符で囲まないでください
​
image_urls
array<url>
参照画像 URL リスト、画像から画像生成や画像編集に使用制限： 最大5枚
​
mask_url
string
マスク画像 URL
  • PNG 形式である必要があります
  • サイズは参照画像と一致する必要があります
  • 最大 4MB

​
レスポンスパラメータ

​
code
string
レスポンスステータスコード
  • success - リクエスト成功、タスク送信済み
​
data
string
タスク ID、形式は task-wave{timestamp}{userId}{random}タスクステータス照会 インターフェースで生成結果を取得するために使用します

​
注意事項

  1. 非同期処理： タスク送信後に非同期で処理されます。タスクステータス照会 で生成結果を取得してください
  2. リンクの有効期限： 生成された画像リンクの有効期限は24時間です。速やかにダウンロードして保存してください
  3. 画像 URL の要件： 入力する参照画像はパブリックにアクセス可能な URL または Base64 形式である必要があります
  4. 料金について： n が1より大きい場合、料金は数量に応じて先払いされます