メインコンテンツへスキップ
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": "z-image-turbo",
    "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": "z-image-turbo",
    "prompt": "水墨画風の山水風景"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01JGXYZ1234567890ABCDEF"
    }
  ]
}

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

モデル名説明生成枚数課金方式
z-image-turbo軽量高速な画像生成、中国語と英語をサポート固定1枚固定価格

認証

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

Body

model
string
必須
モデル名
  • z-image-turbo - 軽量高速な画像生成、中国語と英語をサポート
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 - 高精細解像度
prompt_extend
boolean
デフォルト:"false"
スマートプロンプト書き換え有効にすると、AIが自動的にプロンプトを最適化し、より良い結果を生成し、費用が増加します。
  • false - 無効(デフォルト)
  • true - 有効

解像度対照表

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

使用例

基本テキストから画像(最小リクエスト)
{
  "model": "z-image-turbo",
  "prompt": "水墨画風の山水風景"
}
比率と解像度を指定
{
  "model": "z-image-turbo",
  "prompt": "ミニマリストスタイルのカフェインテリアデザイン",
  "size": "16:9",
  "resolution": "2K"
}
スマートプロンプト書き換えを有効化
{
  "model": "z-image-turbo",
  "prompt": "猫",
  "prompt_extend": true
}

Response

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

注意事項

  1. 非同期処理:送信後にtask_idが返されます、結果を取得するには/v1/tasks/{task_id}をポーリングしてください
  2. 画像保存:生成された画像はプラットフォームCDNにミラーリングされ、長期間有効です
  3. 課金ルール:正常に生成された画像の枚数に応じて課金、失敗した場合は課金されません
  4. 固定枚数:Z-Image-Turboは1リクエストにつき固定1枚生成、nパラメータはサポートされていません