メインコンテンツへスキップ
POST
https://api.apimart.ai
/
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": "flux-kontext-pro",
    "prompt": "髪の色を青に変える",
    "image_urls": ["https://example.com/input.png"],
    "size": "16:9"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-kontext-pro",
    "prompt": "髪の色を青に変える",
    "image_urls": ["https://example.com/input.png"],
    "size": "16:9"
  }'

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

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

モデル名説明課金方式
flux-kontext-proFlux Kontext Pro 画像編集モデル固定価格
flux-kontext-maxFlux Kontext Max 画像編集モデル（より高品質）固定価格

​
認証

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

​
Body

​
model
string
必須
モデル名
  • flux-kontext-pro - Kontext Proモデル
  • flux-kontext-max - Kontext Maxモデル（より高品質）
​
prompt
string
必須
画像生成のテキスト説明
​
image_urls
array
入力画像URLリスト制限：
  • 1枚のみサポート
  • 公開アクセス可能なURLである必要があります
  • Base64形式はサポートされていません
​
size
string
デフォルト:"画像あり: match_input_image、なし: 16:9"
画像のアスペクト比サポートされているアスペクト比:
  • match_input_image - 入力画像の比率に合わせる（画像提供時のデフォルト）
  • auto - match_input_imageと同じ
  • 1:1 - 正方形
  • 4:3 - 横向き 4:3
  • 3:4 - 縦向き 3:4
  • 16:9 - 横向きワイドスクリーン（画像なしの場合のデフォルト）
  • 9:16 - 縦向き
  • 3:2 - 横向き 3:2
  • 2:3 - 縦向き 2:3
  • 21:9 - ウルトラワイド
  • 9:21 - ウルトラトール
​
response_format
string
デフォルト:"png"
出力画像形式
  • png - PNG形式（デフォルト）
  • jpg - JPEG形式
​
safety_tolerance
integer
デフォルト:"2"
安全許容度範囲：0-6、値が高いほど寛容
​
prompt_upsampling
boolean
デフォルト:"false"
プロンプト強化を有効にする
  • true - 有効
  • false - 無効（デフォルト）

​
使用例

画像編集（入力画像あり） 
{
    "model": "flux-kontext-pro",
    "prompt": "背景をビーチに変更",
    "image_urls": ["https://example.com/photo.jpg"]
}
テキストから画像（入力画像なし） 
{
    "model": "flux-kontext-pro",
    "prompt": "青い猫",
    "size": "16:9"
}

​
Response

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

​
注意事項

  1. 画像URL要件：入力画像は公開アクセス可能なURLである必要があります、base64はサポートされていません
  2. 結果保存：生成された画像は自動的に保存され、URLは24時間有効です
  3. タスクポーリング：タスクは非同期で処理されます、結果を取得するには /v1/tasks/{task_id} をポーリングしてください
  4. 入力画像制限：1枚のみサポート