Seedream 4 API
Crisp, illustrative ByteDance model.
Integrate Seedream 4 with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.
model: "seedream-4" What's special about Seedream 4
- 5 aspect ratios, including 1:1, 3:4, 4:3.
- Image-to-image editing and reference-image support.
- Fast turnaround — about 12s per generation on average.
- Pay-as-you-go pricing with no ByteDance account required — you only pay for successful generations.
- One API key, unified billing, idempotency and webhooks across every Apiframe model.
Made with Seedream 4
A few outputs generated through the Seedream 4 API on Apiframe.
A cinematic portrait of an astronaut in a neon-lit alley, 85mm, shallow depth of field
Cozy isometric coffee shop, warm morning light, highly detailed 3D render
A majestic snow leopard on a misty mountain ridge at golden hour
Overview
- Endpoint
- POST /v2/images/generate
- Model ID
- seedream-4
- Params key
- seedreamParams
- Modality
- image
- Provider
- ByteDance
- Pricing
- Pay-as-you-go
- Avg. completion
- ~12s
Capabilities
Quick start
Send a single POST /v2/images/generate request with your API key to
generate with Seedream 4. The call returns a jobId you can poll or
receive via webhook.
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "seedream-4",
"seedreamParams": {
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"guidance_scale": 3,
"use_pre_llm": false
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "seedream-4",
"seedreamParams": {
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"guidance_scale": 3,
"use_pre_llm": False
}
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "seedream-4",
"seedreamParams": {
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"guidance_scale": 3,
"use_pre_llm": false
}
}),
});
const { jobId } = await response.json();
console.log(jobId);Response & job lifecycle
Generation is asynchronous. A successful submission returns 202 Accepted
with a jobId. Poll GET /v2/jobs/{id} (or supply a
webhook_url) until the status is COMPLETED; the
result field then holds the output URL(s).
1. Submission response (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. Poll for the result
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"import requests, time
while True:
job = requests.get(
"https://api.apiframe.ai/v2/jobs/JOB_ID",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(2)
print(job["result"])let job;
do {
await new Promise((r) => setTimeout(r, 2000));
job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
headers: { "X-API-Key": "afk_your_api_key_here" },
}).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);Input schema
Request parameters accepted by the Seedream 4 endpoint. Model-specific options are nested under the params object shown below.
| Parameter | Type | Required | Default | Allowed / range | Description |
|---|---|---|---|---|---|
| prompt | string | required | — | — | Text description of what to generate. |
| model | string | required | "seedream-4" | "seedream-4" | The model identifier for this endpoint. |
| seedreamParams.image_input | string (URL) | optional | — | — | Reference image (URL) |
| seedreamParams.output_format | string | optional | "jpg" | "jpg", "png" | Output format |
| seedreamParams.guidance_scale | number | optional | 3 | min 1, max 10, step 0.5 | Guidance |
| seedreamParams.use_pre_llm | boolean | optional | false | — | Pre-process the prompt with an LLM. |
| seedreamParams.enhance_prompt | boolean | optional | false | — | Enhance prompt |
| seedreamParams.seed | number | optional | — | step 1 | Reuse a number to reproduce the same result. |
Frequently Asked Questions
Common questions about the Seedream 4 API.
Is there an API for Seedream 4?
Yes. Apiframe exposes Seedream 4 through a single REST endpoint (`POST /v2/images/generate` with `model: "seedream-4"`). You get one unified API, key, and billing across every supported model — no separate ByteDance account required.
How much does the Seedream 4 API cost?
Seedream 4 uses simple pay-as-you-go pricing on Apiframe — you only pay for successful generations. See the pricing page for plans and volume discounts.
How do I call the Seedream 4 API?
Send a POST request to `/v2/images/generate` with your `X-API-Key` and a JSON body containing `model: "seedream-4"`. The call returns a `jobId`; poll `GET /v2/jobs/{id}` or use a webhook to receive the result.
What parameters does Seedream 4 support?
Seedream 4 accepts 6 model-specific parameters (nested under `seedreamParams`) plus the common `prompt` and `webhook_url` fields. See the input schema above for the full list with types and defaults.
Still have questions?
Start building with the Seedream 4 API
Get your API key and integrate Seedream 4 in minutes — Pay-as-you-go.
Questions? Join our Discord or contact sales.