Kikaku API

Quota Used

- / -

Remaining

Success Rate

Avg Response

Status: Email: Expires:

Generate Image

Model *

Prompt *

Reference Image URL (optional)

Size

Format

Number of Images

Add watermark

Generated image will appear here

My Request Logs

Start Date

End Date

ID	Model	Status	Response Time	Timestamp	Error
Click "Filter" to load logs

📖 API Documentation

How to use the SeedDream Image Generation API

🔑 Authentication

Include your API key in every request:

Authorization: Bearer kikaku_YOUR_API_KEY

🤖 Available Models

Model	Resolution	Features
seedream-4.5	2K, 4K	Text→Image, Image→Image, Multi-ref, Streaming
seedream-4.0	1K, 2K, 4K	Text→Image, Image→Image, Multi-ref, Streaming, Fast mode

POST /v1/images/generations

Generate images using text prompts and optional reference images.

Parameters:

Param	Type	Required	Description
model	string	Yes	`seedream-4.0` or `seedream-4.5`
prompt	string	Yes	Text description of desired image
n	integer	No	Number of images to generate (1–8). Enables batch mode automatically. Default: `1`
image	string \| string[]	No	Reference image URL(s). Up to 14 images.
size	string	No	`1K`, `2K`, `4K` or pixels (e.g., `2048x2048`)
response_format	string	No	`url` or `b64_json`
watermark	boolean	No	Add AI watermark
sequential_image_generation	string	No	`auto` (batch mode) or `disabled`. Default: `disabled`. Requires `stream: false`. Auto-set when `n` > 1
sequential_image_generation_options	object	No	`{ "max_images": N }` — Max images (refs + output ≤ 15). Auto-set when `n` > 1

Example: Single Image (cURL):

curl -X POST YOUR_BASE_URL/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kikaku_YOUR_KEY" \
  -d '{
    "model": "seedream-4.5",
    "prompt": "A magical forest with glowing mushrooms",
    "size": "2K",
    "response_format": "url",
    "watermark": false
}'

Example Request (Python):

import requests

resp = requests.post(
    "YOUR_BASE_URL/v1/images/generations",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer kikaku_YOUR_KEY"
    },
    json={
        "model": "seedream-4.5",
        "prompt": "A magical forest with glowing mushrooms",
        "size": "2K",
        "response_format": "url",
        "watermark": False
    }
)
print(resp.json()["data"][0]["url"])

Batch Generation (cURL) — using `n` parameter:

The gateway automatically sets sequential_image_generation: "auto", max_images, and stream: false for you.

curl -X POST YOUR_BASE_URL/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kikaku_YOUR_KEY" \
  -d '{
    "model": "seedream-4.5",
    "prompt": "Generate 4 illustrations of a courtyard across the four seasons",
    "size": "2K",
    "n": 4,
    "response_format": "url",
    "watermark": false
}'

💡 How batch works: The gateway sends sequential_image_generation: "auto" with stream: false to SeedDream. If the API returns fewer images than requested, the gateway automatically makes parallel individual calls to fill the remaining slots — ensuring you always get the exact number of images requested.

Batch Generation — using native SeedDream parameters:

You can also pass sequential_image_generation directly. Requires stream: false.

curl -X POST YOUR_BASE_URL/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kikaku_YOUR_KEY" \
  -d '{
    "model": "seedream-4.5",
    "prompt": "Generate 4 illustrations of a courtyard across the four seasons",
    "size": "2K",
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": { "max_images": 4 },
    "stream": false,
    "response_format": "url",
    "watermark": false
}'

⚠️ Important: When using sequential_image_generation directly, you must set "stream": false. Without it, the API may only return 1 image. Using the n shortcut is recommended.

Batch Response (multiple images):

{
  "created": 1234567890,
  "data": [
    { "url": "https://...image1.jpg", "size": "2048x2048" },
    { "url": "https://...image2.jpg", "size": "2048x2048" },
    { "url": "https://...image3.jpg", "size": "2048x2048" },
    { "url": "https://...image4.jpg", "size": "2048x2048" }
  ],
  "usage": { "prompt_tokens": 0, "completion_tokens": 4, "total_tokens": 4 }
}

Success Response:

{
  "created": 1234567890,
  "data": [{ "url": "https://...", "size": "2048x2048" }],
  "usage": { "prompt_tokens": 0, "completion_tokens": 1, "total_tokens": 1 }
}

📐 Recommended Sizes

Ratio	1K	2K	4K
1:1	1024x1024	2048x2048	4096x4096
16:9	1312x736	2848x1600	5504x3040
9:16	736x1312	1600x2848	3040x5504
3:4	864x1152	1728x2304	3520x4704
4:3	1152x864	2304x1728	4704x3520

GET /v1/usage

Check your quota and usage statistics.

curl -H "Authorization: Bearer kikaku_YOUR_KEY" YOUR_BASE_URL/v1/usage

GET /v1/logs

View your request history. Supports start_date, end_date, page, limit query params.

curl -H "Authorization: Bearer kikaku_YOUR_KEY" "YOUR_BASE_URL/v1/logs?page=1&limit=20"

⚡ Rate Limits & Errors

10 requests/minute per API key
401 — Invalid/missing API key
403 — Key suspended or expired
429 — Rate limit or quota exceeded
Image URLs expire after 24 hours — save promptly

⚠️ Image Input Limitations

Formats: JPEG, PNG, WEBP, BMP, TIFF, GIF
Aspect ratio: 1/16 to 16
Min dimensions: 14px width and height
Max size: 10 MB
Max pixels: 6000 × 6000 = 36M px
Max reference images: 14