Ideogram Character API — 如何接入并付费

API 契约

生成是异步的：先创建任务，然后轮询状态直至完成。

创建任务

POST /api/media/generate

检查状态

GET /api/media/jobs/{jobId}

输入

text, image

输出

image

轮询

每 3 秒 · 最多 90 秒

鉴权

Authorization: Bearer sk-pv-…

API 请求参数

通过 GetVibe API 向 Ideogram Character 发起请求的参数。

请求：POST https://getvibeapi.com/api/media/generate。价格以 USD 计。

Ideogram Character 的价格

Ideogram Character 的费用：从 $0.12 per image。价格按当前汇率动态计算，最终扣费见 API 响应（priceRub）。以 USD 支付，无订阅。

README

Ideogram Character 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。

# Ideogram Character

公开模型：ideogram-character
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}

## 输入参数
- `prompt` (text): text description; 默认: required
- `image_url` (URL): Public image URL; 默认: —
- `aspect_ratio` (option selection): 1:1 (default) · 16:9 · 9:16 · 4:3 · 3:4; 默认: 1:1
- `mode` (option selection): Create character (default) · Edit character (Canvas only) · Remix character; 默认: Create character
- `rendering_speed` (option selection): Turbo · Default (default) · Quality; 默认: Default
- `style` (option selection): Auto (default) · Realistic · Fiction; 默认: Auto
- `expand_prompt` (yes/no): Yes · No (default); 默认: No
- `seed` (text / number): any value; 默认: —
- `negative_prompt` (text / number): any value; 默认: —
- `strength` (option selection): 0.8 (default) (default) · 0.2 · 0.4 · 0.6 · 1.0; 默认: 0.8 (default)
- `num_images` (option selection): 1 (default) · 2 · 3 · 4; 默认: 1
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; 默认: —
- `input_urls` (Array<URLs>, 1–1 items): Public HTTP(S) URLs; 默认: required
- `input_file_ids` (Array<strings>): List of values; 默认: —
- `input_base64` (Array<strings>): List of values; 默认: —

## 公开变体
- `ideogram-character`: Pixel
- `ideogram-character:rep`: Canvas