Magick API ユーザーガイド

`/v1/images/generations` を通じて Qwen Image シリーズを呼び出します。現在のプロジェクトでは同期画像インターフェースとして `ImageResponse` を返し、task_id によるポーリングは使用しません。

ルート: POST /v1/images/generations
成功時は同期的に ImageResponse を返します

推奨リクエスト例

curl --request POST \
  --url https://api.magickapi.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image",
    "prompt": "日向でうたた寝するかわいいオレンジ色の猫",
    "n": 1,
    "response_format": "url",
    "parameters": {
      "size": "1024*1024",
      "watermark": false
    }
  }'

成功レスポンス例

{
  "created": 1712345678,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "b64_json": "",
      "revised_prompt": ""
    }
  ]
}

エラーレスポンス例

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request"
  }
}

確認可能なフィールド

標準画像フィールド

現在のプロジェクトで公開されている画像インターフェースでは、以下の標準フィールドが利用可能であることが保証されています。

model
prompt
n
size
quality
response_format

Qwen / Alibaba 拡張フィールド

Alibaba 互換の拡張機能を使用する場合は、旧ドキュメントにあったトップレベルの拡張フィールドではなく、ネストされたオブジェクトを使用してください。

parameters
input

例:

{
  "model": "qwen-image",
  "prompt": "サイバーパンク都市の夜景",
  "parameters": {
    "size": "1536*1024",
    "n": 2,
    "watermark": false
  }
}

互換性に関する注意

画像編集には /v1/images/edits または /v1/edits を使用してください

Qwen Image 画像生成