Cosmos 3 AI

Cosmos 3 Super API

Generate images and image-to-video tasks through cosmos3ai.org.

Use these server API routes from an authenticated cosmos3ai.org session. They proxy to the configured Cosmos 3 Super upstream, defaulting to node103, and use the same credits as the studio: 4 credits per image and 5 credits per video second.

Authentication

Keep the signed-in session cookie and send the user's API key in the Authorization header. The server adds the internal service key before calling the upstream.

Authorization: Bearer <api_key>
Content-Type: application/json

Costs

  • Text to image: 4 credits per generated image.
  • Image to video: duration x 5 credits, duration 1-7 seconds.
  • Credits are deducted by the upstream task service after request validation.

Image Generate

POST /api/image/cosmos-3-super/generate

{
  "prompt": "A rover crossing a dusty alien valley",
  "size": "16:9",
  "num_inference_steps": 28,
  "guidance_scale": 4,
  "output_format": "jpeg",
  "negative_prompt": "blur, artifacts"
}

Video Generate

POST /api/video/cosmos-3-super/generate

{
  "prompt": "Slow cinematic motion with realistic light",
  "image": "https://example.com/source.jpg",
  "size": "16:9",
  "duration": 7,
  "num_inference_steps": 28,
  "guidance_scale": 6,
  "negative_prompt": "warping, flicker"
}

Status

Poll either endpoint with the returned task_id.

GET /api/image/cosmos-3-super/status?task_id=<task_id>
GET /api/video/cosmos-3-super/status?task_id=<task_id>

History

List tasks for the signed-in API key. Results are scoped to the model type.

GET /api/image/cosmos-3-super/list?api_key=<api_key>&page=1&limit=12
GET /api/video/cosmos-3-super/list?api_key=<api_key>&page=1&limit=12

Limits

  • Prompt length: 1-2500 characters.
  • Steps: 1-50.
  • Guidance scale: 0-20.
  • Image sizes: 1:1, 3:4, 9:16, 4:3, 16:9.
  • Video sizes: 16:9, 4:3, 1:1, 3:4, 9:16.
  • Video duration: 1-7 seconds.

Upstream Config

Set COSMOS3_SUPER_API_BASE or NUXT_COSMOS3_SUPER_API_BASE to override the default upstream.

COSMOS3_SUPER_API_BASE=https://n103.goglo.top