POST/api/v1/imagine6 creditsSynchronous

Ideogram v3

Provider · IdeogramType · T2IModel ID · ideogram-v3Upstream ID · ideogram-generate-v3

Ideogram v3. Industry-leading text rendering in images. Best choice when your generation requires legible typography, logos, signage, or any visible text. Premium credit cost reflects expensive upstream pricing.

Request Parameters

Parameter	Type	Required	Description
prompt	`string`	Required	The text prompt describing the image to generate.
model	`string`	Optional	Set to `ideogram-v3` to use this model.Default: `ideogram-v3`
aspect_ratio	`string`	Optional	Output aspect ratio. Allowed: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3.Default: `1:1`
webhook_url	`string`	Optional	URL where we POST the completed task result.
webhook_secret	`string`	Optional	Sent as x-webhook-secret header in webhook delivery for verification.

Example Request

cURL

curl -X POST https://api.journeyapi.com/api/v1/imagine \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v3",
    "prompt": "a vintage travel poster with the text "PARIS" in bold art deco typography",
    "aspect_ratio": "3:4"
  }'

Response

This model is synchronous — the response includes the finished image_url directly. No polling required.

200 OK

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "finished",
  "image_url": "https://cdn.example.com/output.png"
}

Tips

1Best model available for text-in-image tasks: logos, signage, typographic art.
2Enclose text you want rendered exactly in double quotes within your prompt.