メインコンテンツへスキップ
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-2.0",
    "prompt": "日差しの中でうたた寝するかわいい茶トラ猫"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image-2.0",
    "prompt": "日差しの中でうたた寝するかわいい茶トラ猫"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

​
サポートされているモデル

モデル名説明最大枚数課金方式
qwen-image-2.0標準版、品質とパフォーマンスのバランス6枚固定価格
qwen-image-2.0-proPro版、テキストレンダリングが強力、リアルな質感がより繊細6枚固定価格

​
認証

​
Authorization
string
必須
すべてのエンドポイントはBearer Token認証が必要ですAPI Keyの取得：API Key管理ページでAPI Keyを取得してくださいリクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
必須
モデル名
  • qwen-image-2.0 - 標準版、品質とパフォーマンスのバランス
  • qwen-image-2.0-pro - Pro版、テキストレンダリングが強力、リアルな質感がより繊細
​
prompt
string
必須
画像生成のテキスト説明、最大800文字
​
size
string
デフォルト:"1:1"
画像のアスペクト比サポートされているアスペクト比：
  • 1:1 - 正方形（デフォルト）
  • 4:3 - 横向き 4:3
  • 3:4 - 縦向き 3:4
  • 16:9 - 横向きワイドスクリーン
  • 9:16 - 縦向き
  • 3:2 - 横向き 3:2
  • 2:3 - 縦向き 2:3
​
resolution
string
デフォルト:"1K"
解像度レベル
  • 1K - 標準解像度（デフォルト）
  • 2K - 高精細解像度
​
n
integer
デフォルト:"1"
生成する画像の枚数範囲：1-6
​
negative_prompt
string
ネガティブプロンプト（表示させたくないコンテンツ）、最大500文字
​
image_urls
array
参照画像URL配列（画像から画像モード）制限：
  • 公開アクセス可能なURLである必要があります
  • Base64形式はサポートされていません

​
解像度対照表

size（比率）+ resolution（解像度レベル）の組み合わせで出力サイズを制御します。
比率1Kレベル2Kレベル
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×2048
  • sizeのみ → デフォルト1Kレベル：{"size": "16:9"} → 1280×720
  • size + resolution → 指定レベル：{"size": "16:9", "resolution": "2K"} → 2048×1152

​
使用例

テキストから画像（最小リクエスト） 
{
  "model": "qwen-image-2.0",
  "prompt": "日差しの中でうたた寝するかわいい茶トラ猫"
}
比率と枚数を指定 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "サイバーパンク風の未来都市の夜景、ネオンライトが点滅",
  "size": "16:9",
  "n": 4
}
高精細2Kレベル 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "精巧なフードフォトグラフィー、寿司盛り合わせ",
  "size": "4:3",
  "resolution": "2K",
  "n": 2
}
画像から画像（参照画像 + テキスト説明） 
{
  "model": "qwen-image-2.0",
  "prompt": "背景を海辺の夕日に変更",
  "image_urls": ["https://example.com/my-photo.jpg"]
}

​
Response

​
code
integer
レスポンスステータスコード
​
data
array
レスポンスデータ配列

​
注意事項

  1. 非同期処理：送信後にtask_idが返されます、結果を取得するには/v1/tasks/{task_id}をポーリングしてください
  2. 画像保存：生成された画像はプラットフォームCDNにミラーリングされ、長期間有効です
  3. 課金ルール：正常に生成された画像の枚数に応じて課金、失敗した場合は課金されません
  4. 画像URL要件：入力画像は公開アクセス可能なURLである必要があります、base64はサポートされていません