Seedream seedream-v4-text-to-image API
Same API key, same model skill workflow — switch variants by changing one model ID.
curl -X POST https://runapi.ai/api/v1/seedream/text_to_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-v4-text-to-image",
"prompt": "Create a social media graphic for a coffee shop sale with the text '50% OFF' in bold, warm tones, 4K."
}'
import { SeedreamClient } from "@runapi.ai/seedream";
const client = new SeedreamClient();
const result = await client.textToImage.run({
model: "seedream-v4-text-to-image",
prompt: "Create a social media graphic for a coffee shop sale with the text '50% OFF' in bold, warm tones, 4K.",
});
require "runapi/seedream"
client = RunApi::Seedream::Client.new
result = client.text_to_image.run(
model: "seedream-v4-text-to-image",
prompt: "Create a social media graphic for a coffee shop sale with the text '50% OFF' in bold, warm tones, 4K."
)
npx skills add runapi-ai/seedream -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
seedream-v4-text-to-image targets the sweet spot of quality and cost within the Seedream family.
- Pay-per-call pricing in USD
- Failed generations not charged
- Streaming when supported by the model
- Schema-validated tool calls
Pricing
Technical details
| Model ID | seedream-v4-text-to-image |
| Provider | Bytedance |
| Modality | image |
| Task type | asynchronous |
| Billing unit | call |
| API endpoint | /api/v1/seedream/text_to_image |
| Commercial license | Yes — included via API |
| Status | Operational |
Model skill — seedream-v4-text-to-image
Install the skill once, then use the variant ID from this page while building.
# Install the model skill for app development workflows
npx skills add runapi-ai/seedream -g
Install the Seedream skill for this app: 1. Add runapi-ai/seedream with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Use seedream-v4-text-to-image with a model skill
Install
Install the model skill for this model line.
Configure
Set the model field to the full model ID shown on this page.
Call
Use the skill instructions while adding prompt, input, and callback handling to your app.
Receive
Read the task response, webhook callback, or cached output URL from RunAPI.
What's different about seedream-v4-text-to-image
Photorealistic 1K-4K batches; up to 6 images per prompt
Same realism with targeted region editing via mask/brush
Photorealistic 1K-4K batches; up to 6 images per prompt
Photorealistic output; stable anatomy; 8–14s generation
Photorealistic 1K-4K batches; up to 6 images per prompt
Stronger reference adherence + bilingual typography vs 4.5; faster
Best for
Product photography
Auto-generate lifestyle product photos for e-commerce catalogs that lack studio photography.
Game & concept art
Rapidly concept environments and characters before committing to final art.
Editorial illustration
Generate unique cover art and illustrations for blog posts and articles at scale.
Frequently asked questions about seedream-v4-text-to-image
Is the model ID stable across versions?
RunAPI keeps the model ID stable and handles compatible version refreshes without changing your request shape.
What's the rate limit on this variant?
Per-key rate limits scale with usage tier. See pricing page for current limits.
Can I switch variants later?
Yes — variant is a flag. Switch by changing the model parameter.
Does it stream?
Where streaming is available, RunAPI streams end-to-end.
Where do I report quality issues?
Open an issue on the public GitHub repo or email support.