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": "Create a minimalist product photo: a white ceramic aroma diffuser on a light wood table, natural morning side light, 1:1 composition"}]
    }],
    "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": "Keep the product shape and logo, and replace the background with a wooden table by the sea at dawn with natural side light"},
        {"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": "A friendly corgi pilot mascot wearing aviator goggles, full body, isolated, clean edges, no shadow, no text",
    "n": 1,
    "size": "1536x1024",
    "quality": "high",
    "output_format": "png",
    "background": "transparent"
  }'

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="A friendly corgi pilot mascot wearing aviator goggles, full body, isolated, clean edges, no shadow, no text",
    size="1536x1024",
    quality="high",
    output_format="png",
    background="transparent",
)

with open("corgi-transparent.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=Keep the product itself, the logo and all packaging text completely unchanged; replace the background with a wooden tabletop by the seaside in the early morning, natural side light, shallow depth of field" \
  -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="Keep the product itself, the logo and all packaging text completely unchanged; replace the background with a wooden tabletop by the seaside in the early morning",
    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": "A Mid-Autumn Festival gift-box key visual in guochao illustration style, deep cyan background with gold-foil patterns, a box of mooncakes at the center, soft light and shadow, neatly arranged negative space",
    "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": "Edit the image based on the hand-drawn sketch: add a stack of magazines in the marked area at the lower-left, add a cup of coffee with a saucer in the marked area on the right, remove all sketch lines, keep the composition unchanged, and blend the new objects naturally into the original scene",
    "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": "Move the subject in image 1 179 283 796 986 to the position 118 331 933 871 in image 2",
  "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": "Vertical outdoor portrait photography: a newsstand on a European street corner backlit in the afternoon, vines and small orange flowers hanging from the eaves, a sunlit street on the right side of the frame, warm film texture, fine grain, shallow depth of field" }
          ]
        }
      ]
    },
    "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": "Keep the person's facial features and long black hair from the input image; change the outfit to a champagne silk shirt under a dark gray blazer; change the scene to a modern, minimalist high-end café, afternoon side light, background naturally blurred" }
          ]
        }
      ]
    },
    "parameters": {
      "prompt_extend": true,
      "negative_prompt": "deformed fingers, text watermark, low resolution",
      "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."
}