The project is in a healthy, maintained state
The Ideogram V3 Ruby SDK is the language-specific package for Ideogram V3 on RunAPI. Use this package for image generation, image editing, and creative production workflows when your application needs 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.3.0
 Project Readme

RunAPI

Ideogram V3 API SDKs for JavaScript, Python, Ruby, Go, Java, and PHP on RunAPI.

npm PyPI RubyGems Go Reference Maven Central License


The Ideogram V3 API SDK packages JavaScript, Python, Ruby, Go, Java, and PHP clients for Ideogram V3 on RunAPI. Use it for text-to-image, image remix, reframe, and edit workflows when your app needs typed request builders, predictable task polling, file upload helpers, account helpers, and consistent RunAPI errors.

Ideogram V3 is listed in the RunAPI model catalog at https://runapi.ai/models/ideogram-v3. Variant pages below carry pricing, rate-limit, and commercial-usage details. The public ideogram-v3-sdk repository groups the non-PHP language packages, examples, CI, and release tags for this model. The PHP package is released from a split Composer repository.

Install

npm install @runapi.ai/ideogram-v3
pip install runapi-ideogram-v3
gem install runapi-ideogram-v3
go get github.com/runapi-ai/ideogram-v3-sdk/go@latest

Gradle:

dependencies {
  implementation("ai.runapi:runapi-ideogram-v3:0.1.1")
}

Maven:

<dependency>
  <groupId>ai.runapi</groupId>
  <artifactId>runapi-ideogram-v3</artifactId>
  <version>0.1.1</version>
</dependency>

Use the Java BOM when installing multiple RunAPI Java modules:

dependencies {
  implementation(platform("ai.runapi:runapi-bom:0.2.9"))
  implementation("ai.runapi:runapi-ideogram-v3")
}

The PHP package is published from the split Composer repository as runapi-ai/ideogram-v3; see https://github.com/runapi-ai/ideogram-v3-php for PHP install and examples.

What you can build

  • Build apps, agent workflows, batch jobs, and production services around Ideogram V3 requests.
  • Install only the language package your app needs while keeping one model-specific repository for docs and releases.
  • Use create for submit-only jobs, get for status lookup, and run for submit-and-poll scripts.
  • Upload local files, URL files, or base64 files through shared RunAPI file helpers.
  • Handle validation, authentication, rate limits, insufficient credits, task failures, and polling timeouts through RunAPI SDK errors.

Java quick start

import ai.runapi.ideogramv3.IdeogramV3Client;
import ai.runapi.ideogramv3.types.TextToImageParams;
import ai.runapi.ideogramv3.types.CompletedTextToImageResponse;
import ai.runapi.ideogramv3.types.TextToImageModel;

IdeogramV3Client client = IdeogramV3Client.builder()
    .apiKey(System.getenv("RUNAPI_API_KEY"))
    .build();

CompletedTextToImageResponse result = client.textToImage().run(
    TextToImageParams.builder()
        .model(TextToImageModel.IDEOGRAM_V3_CHARACTER)
        .prompt("A bold poster reading RUNAPI in crisp lettering")
        .aspectRatio("1:1")
        .build()
);

Java packages target Java 8 bytecode and are tested on Java 8, 11, 17, and 21. Each model artifact depends on ai.runapi:runapi-core, so application code normally installs only ai.runapi:runapi-ideogram-v3.

Task lifecycle

Most media endpoints are asynchronous. create() submits a task and returns its id, get(id) fetches the latest task state, and run(params) creates the task and polls until it reaches a terminal state. In 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/ideogram-v3.
  • python/ publishes runapi-ideogram-v3.
  • ruby/ publishes runapi-ideogram-v3.
  • go/ publishes github.com/runapi-ai/ideogram-v3-sdk/go and depends on github.com/runapi-ai/core-sdk/go.
  • java/ publishes ai.runapi:runapi-ideogram-v3 and depends on ai.runapi:runapi-core.

Public links

Pricing and variants

Use the most specific Ideogram V3 variant page for pricing, rate limits, and commercial usage:

Default pricing link for the Ideogram V3 SDK: https://runapi.ai/models/ideogram-v3/text-to-image

File storage

RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.

FAQ

Which package should I install for Ideogram V3 work?

Install the model package for your language: @runapi.ai/ideogram-v3 on npm, runapi-ideogram-v3 on PyPI, runapi-ideogram-v3 on RubyGems, github.com/runapi-ai/ideogram-v3-sdk/go, ai.runapi:runapi-ideogram-v3 on Maven Central, or runapi-ai/ideogram-v3 on Packagist. Install core SDK packages only when you are building shared SDK infrastructure.

Where should public links point?

Primary Ideogram V3 links point to https://runapi.ai/models/ideogram-v3. Pricing and usage-policy links point to variant pages such as https://runapi.ai/models/ideogram-v3/text-to-image. Provider comparisons point to https://runapi.ai/providers/ideogram, and broad browsing points to https://runapi.ai/models.

License

Licensed under the Apache License, Version 2.0.