一つの共通 API で画像・動画と一部の言語モデルを接続しましょう。

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image は実際に呼び出せるテキストから画像を生成するエンドポイントです。別のメディアモデルに切り替える場合は、そのモデルの正確な ID とスキーマを使ってください。

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "job_01k...",
    "state": "queued"
  },
  "request_id": "req_01k..."
}

レスポンスの抜粋です。例の ID と URL は実際のレスポンスの値に置き換えてください。

curl 'https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=job_01k...' \
  -H "Authorization: Bearer $SPICY_API_KEY"

{
  "code": 200,
  "data": {
    "taskId": "job_01k...",
    "state": "succeeded",
    "output": {
      "assets": [{
        "key": "tasks/.../output.png",
        "url": "https://example.com/result.png?signature=FROM_RESPONSE",
        "expiresAt": "2026-10-07T12:20:00Z",
        "mime": "image/png"
      }]
    },
    "settled": true
  }
}

レスポンスの抜粋です。例の ID と URL は実際のレスポンスの値に置き換えてください。

# Copy data.output.assets[0].url from the task response
curl -L -o result.png "URL_FROM_TASK_RESPONSE"

data.output.assets[0].url を API キーなしで直接ダウンロードします。URL は通常 20 分で失効するため、タスクを再取得して新しい URL を受け取り、残すファイルは自分のストレージに保存してください。pending の場合は URL が準備できるまで再取得します。