0.0
The project is in a healthy, maintained state
The seedream api Ruby SDK is the language-specific package for Seedream on RunAPI. Use this seedream api package for text-to-image, image editing, and creative production flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in Ruby.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

~> 0.2.5
 Project Readme

RunAPI

Seedream API SDKs for JavaScript, Ruby, and Go on RunAPI.

npm RubyGems Go Reference License


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@latest

What 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 create for submit-only jobs, get for status lookup, and run for 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/ publishes runapi-seedream when RubyGems publishing resumes.
  • go/ publishes github.com/runapi-ai/seedream-sdk/go and depends on github.com/runapi-ai/core-sdk/go.

Public links

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.