图像（Images）

curl -X POST "https://api.tokgate.io/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "生成一张极简产品摄影：白色陶瓷香薰机放在浅色木桌上，清晨自然侧光，1:1 构图"}]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "2K"}
    }
  }'

curl -X POST "https://api.tokgate.io/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [
        {"text": "保留商品外形与 Logo，把背景改为清晨海边的木桌，自然侧光"},
        {"inlineData": {"mimeType": "image/png", "data": "BASE64_IMAGE_DATA"}}
      ]
    }],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}
  }'

{
  "candidates": [{
    "content": {
      "role": "model",
      "parts": [{
        "inlineData": {
          "mimeType": "image/png",
          "data": "iVBORw0KGgoAAAANSUhEUgAA..."
        }
      }]
    }
  }]
}

curl -X POST https://api.tokgate.io/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴着飞行员护目镜的柯基坐在复古双翼飞机驾驶座上，胶片质感，暖色调，机身写着 tokgate.io",
    "n": 1,
    "size": "1536x1024",
    "quality": "high",
    "output_format": "png"
  }'

import base64
from openai import OpenAI

client = OpenAI(
    api_key="sk-***",
    base_url="https://api.tokgate.io/v1",
)

resp = client.images.generate(
    model="gpt-image-2",
    prompt="一只戴着飞行员护目镜的柯基坐在复古双翼飞机驾驶座上，胶片质感，暖色调",
    size="1536x1024",
    quality="high",
    output_format="png",
)

with open("corgi.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

{
  "created": 1779348818,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }
  ],
  "usage": {
    "total_tokens": 1620,
    "input_tokens": 52,
    "output_tokens": 1568,
    "input_tokens_details": { "text_tokens": 52, "image_tokens": 0 }
  }
}

curl -X POST https://api.tokgate.io/v1/images/edits \
  -H "Authorization: Bearer sk-***" \
  -F "model=gpt-image-2" \
  -F "image=@product.png" \
  -F "mask=@product-mask.png" \
  -F "prompt=保持商品本体、Logo 与包装文字完全不变，把背景换成清晨海边的木质桌面，自然侧光，浅景深" \
  -F "size=1024x1024" \
  -F "output_format=png"

import base64
from openai import OpenAI

client = OpenAI(
    api_key="sk-***",
    base_url="https://api.tokgate.io/v1",
)

resp = client.images.edit(
    model="gpt-image-2",
    image=[open("product.png", "rb")],
    mask=open("product-mask.png", "rb"),
    prompt="保持商品本体、Logo 与包装文字完全不变，把背景换成清晨海边的木质桌面",
    size="1024x1024",
)

with open("product-edited.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

curl -X POST https://api.tokgate.io/api/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "国潮插画风格的中秋节礼盒主图，深青底色配烫金纹样，正中一盒月饼，光影柔和，画面留白规整",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

curl -X POST https://api.tokgate.io/api/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "根据手绘草图编辑图像：在左下角标记区域添加一叠杂志，在右侧标记区域添加一杯带杯碟的咖啡，移除所有草图线条，保持构图不变，让新增物体自然融入原场景",
    "image": "https://your-cdn.example.com/sketch.png",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

{
  "model": "doubao-seedream-5-0-pro-260628",
  "image": ["https://your-cdn.example.com/a.png", "https://your-cdn.example.com/b.png"],
  "prompt": "将图1179 283 796 986的主体放到图2118 331 933 871位置",
  "size": "2K"
}

curl -X POST https://api.tokgate.io/api/v1/services/aigc/multimodal-generation/generation \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "qwen-image-3.0-pro",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            { "text": "竖幅户外人像摄影，午后逆光的欧洲街角报刊亭，藤蔓与橙色小花从檐口垂落，画面右侧是被阳光照亮的街道，暖色胶片质感，细腻颗粒，浅景深" }
          ]
        }
      ]
    },
    "parameters": {
      "prompt_extend": true,
      "n": 1,
      "size": "1024*1536"
    }
  }'

curl -X POST https://api.tokgate.io/api/v1/services/aigc/multimodal-generation/generation \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "qwen-image-3.0-pro",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            { "image": "https://your-cdn.example.com/portrait.png" },
            { "text": "保留输入图中人物的面部特征与黑色长发，换成香槟色真丝衬衫外搭深灰西装外套，场景改为现代简约的高端咖啡店，午后侧光，背景自然虚化" }
          ]
        }
      ]
    },
    "parameters": {
      "prompt_extend": true,
      "negative_prompt": "变形的手指，文字水印，低分辨率",
      "seed": 42
    }
  }'

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            { "image": "https://.../result.png?Expires=..." }
          ]
        }
      }
    ]
  },
  "usage": {
    "width": 1024,
    "height": 1536,
    "image_count": 1
  },
  "request_id": "571ae02f-5c9d-436c-83c2-f221e6df0xxx"
}

{
  "request_id": "31f808fd-8eef-9004-xxxxx",
  "code": "InvalidApiKey",
  "message": "Invalid API-key provided."
}