Seedream API SDKs for JavaScript, Ruby, and Go on RunAPI.
The seedream api SDK packages JavaScript, Ruby, and Go clients for Seedream on RunAPI. Use this seedream api SDK for v4, 4.5, and 5-lite text-to-image and editing workflows that need typed installs, JSON request bodies, task polling, and consistent RunAPI errors across services.
Seedream is available in the RunAPI model catalog. The public model page is https://runapi.ai/models/seedream; variant pages below carry pricing, rate-limit, and commercial-usage details. The public seedream-sdk repository groups the JavaScript, Ruby, and Go packages for this model.
Install
npm install @runapi.ai/seedream
gem install runapi-seedream
go get github.com/runapi-ai/seedream-sdk/go@latestWhat you can build
- Build creative tools, agent pipelines, and production integrations with the seedream api SDK.
- Keep one model-specific repository while installing only the language package your app needs.
- Use
createfor submit-only jobs,getfor status lookup, andrunfor submit-and-poll scripts. - Handle authentication, validation, rate limits, insufficient credits, task failures, and polling timeouts through RunAPI SDK errors.
The JavaScript client exposes textToImage and editImage resources, and the Ruby and Go packages mirror the same RunAPI task lifecycle.
JavaScript quick start
import { SeedreamClient } from '@runapi.ai/seedream';
const client = new SeedreamClient();
const task = await client.textToImage.create({
model: 'seedream-v4-text-to-image',
prompt: 'A precise product render of a glass teapot on white marble',
aspect_ratio: '16:9',
output_resolution: '2k',
output_count: 3,
});
const status = await client.textToImage.get(task.id);For short scripts, use run with the same JSON body to create the task and wait for completion. For web request handlers, prefer create plus webhook or later get polling so the server does not hold a worker open.
Repository layout
-
js/publishes@runapi.ai/seedream. -
ruby/publishesrunapi-seedreamwhen RubyGems publishing resumes. -
go/publishesgithub.com/runapi-ai/seedream-sdk/goand depends ongithub.com/runapi-ai/core-sdk/go.
Public links
- Model page: https://runapi.ai/models/seedream
- SDK docs: https://runapi.ai/docs#sdk-seedream
- Product docs: https://runapi.ai/docs#seedream
- SDK repository: https://github.com/runapi-ai/seedream-sdk
- Skill repository: https://github.com/runapi-ai/seedream
- Full catalog: https://runapi.ai/models
Pricing and variants
Use the most specific seedream api variant page for pricing, rate limits, and commercial usage:
Default pricing link for the seedream api SDK: https://runapi.ai/models/seedream/4.5-text-to-image
FAQ
Which package should I install for seedream api work?
Install the model package for your language: @runapi.ai/seedream, runapi-seedream, or github.com/runapi-ai/seedream-sdk/go. Install core SDK packages only when you are building shared SDK infrastructure.
Where should public links point?
Primary seedream api links point to https://runapi.ai/models/seedream. Pricing and usage-policy links point to variant pages such as https://runapi.ai/models/seedream/4.5-text-to-image, and broad browsing points to https://runapi.ai/models.
License
Licensed under the Apache License, Version 2.0.