LogoQwen API
ログイン
API リファレンス

Qwen API ドキュメント

認証、Qwen 画像生成、非同期タスク、モデル ID、エラー処理をまとめた簡潔なリファレンスです。

API キーを作成モデル

クイックスタート

API は HTTPS 上の標準 JSON を使用します。キーを作成し、生成を送信してタスク ID をポーリングします。

  1. 01

    Bearer キーを作成

  2. 02

    生成リクエストを送信

  3. 03

    タスク ID をポーリング

ベース URL

すべての公開 API リクエストは qwenapi.org ドメインを使用します。

https://qwenapi.org

認証

生成、ステータス、履歴の各リクエストで Qwen API キーを Authorization ヘッダーに設定します。

Authorization: Bearer $QWEN_API_KEY

API キーはサーバー側で保管し、ブラウザバンドル、公開リポジトリ、クライアントログに公開しないでください。

画像を生成

稼働中モデルの ID と、そのモデル固有の入力フィールドを送信します。

POST/api/v1/images/generations
curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3",
    "prompt": "Editorial product photo in soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

受付レスポンス

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n86...qw3",
    "status": "IN_PROGRESS"
  }
}

タスクステータスを取得

タスク ID を使って進捗、エラー、最終出力 URL を取得します。

GET/api/v1/tasks/:task_id
curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $QWEN_API_KEY"

IN_PROGRESS

バックエンドがタスクを受理し、処理中です。

SUCCESS

出力 URL を取得できます。

FAILED

タスクは構造化エラーで停止しました。

稼働中モデル ID

現在、課金対応の本番ルートに接続されるのは以下の ID だけです。

モデルコスト入力出力
qwen-image-310 credits / imageText, up to 3 imagesPNG or JPEG
qwen2-image10 credits / imageText or imagePNG or JPEG
qwen-image-25125 credits / imageText or imagesPNG, JPEG, WebP
qwen-multi-angles5 credits / image1-3 imagesPNG or JPEG
qwen-layered10 credits / layerImage and instructionLayer images

エラー

HTTP ステータスには構造化 JSON エラーが付随します。サポートへの連絡時はタスク ID を保存してください。

400invalid_requestモデル ID とリクエストフィールドを確認してください。
401unauthorizedBearer キーが存在し、有効であることを確認してください。
402insufficient_credits請求ダッシュボードでクレジットを追加してください。
404not_foundタスク ID が Qwen ルートのものか確認してください。
429rate_limitedバックオフとジッターを使って再試行してください。
500server_error後で再試行し、サポート用にタスク ID を保存してください。