開発者リソース

Qwen-Image-2512 API ドキュメント

AlibabaのQwen-Image-2512 AIモデルをアプリケーションに統合。シンプルなREST APIでテキストプロンプトから高品質な画像を生成します。

1

認証

Qwen-Image-2512 APIはBearerトークン認証を使用します。リクエストヘッダーにAPIキーを入力してください。

認証
Authorization: Bearer sk-your-api-key-here

APIキーは安全に保管してください。クライアント側のコードで共有しないでください。

料金

タイプコスト説明
テキストから画像5クレジットQwen-Image-2512 AIを使用してテキストプロンプトから画像を生成します。
2

タスク作成

POSThttps://qwen-image-2512.org/api/generate
非同期生成

料金

各画像生成に5クレジットかかります。

生成タスクを開始します。APIは直ちにtask_idを返し、これを使用して結果をポーリングします。

ボディパラメータ

パラメータタイプ必須説明
promptstring必須画像生成のためのテキスト説明。最大2000文字。
sizestring任意画像サイズ。対応: 1024*1024, 1024*1536, 1536*1024, 768*1024, 1024*768。デフォルト: 1024*1024
seednumber任意再現可能な結果のためのランダムシード。-1でランダム。デフォルト: -1
output_formatstring任意出力形式: jpeg, png, webp。デフォルト: jpeg
callback_urlstring任意タスク完了通知用のWebhook URL。

リクエスト例

テキストから画像の例 (cURL)
curl -X POST https://qwen-image-2512.org/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset",
    "size": "1024*1024",
    "output_format": "png"
  }'
成功レスポンス
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS"
  }
}
エラーレスポンス
{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}
3

ステータス確認

GEThttps://qwen-image-2512.org/api/status

このエンドポイントをポーリングして、タスクの進捗を確認します。5〜10秒ごとのポーリングを推奨します。

クエリパラメータ

パラメータタイプ説明
task_idstring生成エンドポイントから受け取ったタスクID。 必須

ステータス値

PENDINGタスク待ち行列中
IN_PROGRESS処理中
SUCCESS完了
FAILEDエラー発生
cURL
curl -X GET "https://qwen-image-2512.org/api/status?task_id=n43abc123def456qwenimg" \
  -H "Authorization: Bearer YOUR_API_KEY"
レスポンス（進行中）
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}
レスポンス（完了）
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "SUCCESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": ["https://cdn.example.com/image.png"]
  }
}
レスポンス（失敗）
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

エラーコード

コード説明
200成功
400バッドリクエスト - 無効なパラメータ（プロンプトの欠落、無効なサイズなど）
401認証エラー - APIキーの欠落または無効
404未検出 - タスクIDが存在しません
500内部サーバーエラー - 再試行するか、サポートにお問い合わせください

お困りですか？

サポートチャネルを確認するか、メールでお問い合わせください。

サポートに連絡