Images

Generate an image (async)

Queue a text-to-image generation job. Returns immediately with a job_id. Poll GET /v1/jobs/{id} until status is completed, then use download_url.

post/v1/images/generate

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/images/generate
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)

Request body

promptstring required

Text description of the image to generate.

model'standard' | 'lite' | 'pro' | 'flux' | 'seedream' | 'seedream5' | 'gpt-image-2.5-flare'

Model to use for generation. Discover the full list with options via GET /v1/models.

aspect_ratio'1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3'

Aspect ratio of the generated image.

Example request

{
  "prompt": "A serene mountain lake at golden hour, photorealistic"
}

Response

Job queued

successboolean
timestampstring date-time

Example response

{
  "success": true,
  "data": {
    "status": "pending"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.