Canonical model endpoints

Use a model’s provider-independent URL in new integrations. When provider is omitted, Sunra keeps the model’s existing automatic route:

POST https://api.sunra.ai/v1/queue/{owner}/{model}/{operation}

The following canonical models are available for GPT Image 2, Midjourney, and Kling:

Canonical model	Operations
`openai/gpt-image-2`	`text-to-image`, `image-editing`
`midjourney/v7`	`text-to-image`, `image-blending`, `face-swap`, `image-editing`, `action`, `describe`
`midjourney/v8.1`	`text-to-image`, `image-blending`, `face-swap`, `image-editing`, `action`, `describe`
`kling/kling-v3-4k`	`text-to-video`, `image-to-video`
`kling/kling-v3-omni-4k`	`text-to-video`, `image-to-video`, `reference-to-video`

For example:

curl -X POST "https://api.sunra.ai/v1/queue/openai/gpt-image-2/text-to-image" \
  -H "Authorization: Bearer $SUNRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a cinematic sunrise over a quiet harbor","quality":"high"}'

Model names that contain preview remain canonical version names. Preview identifies a model version, not a provider.

Provider routing

Discover the providers that can serve a canonical model and operation:

curl "https://api.sunra.ai/v1/models/google/gemini-2.5-flash-image/providers?operation=text-to-image" \
  -H "Authorization: Bearer $SUNRA_API_KEY"

The response exposes only the provider ID and display name. Availability is scoped to the requested model, operation, organization access, enabled provider route, and endpoint price. To require one provider, add provider.only to the same canonical queue request:

curl -X POST "https://api.sunra.ai/v1/queue/google/gemini-2.5-flash-image/text-to-image" \
  -H "Authorization: Bearer $SUNRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a cinematic sunrise over a quiet harbor",
    "provider": { "only": ["fal"] }
  }'

An unavailable explicit provider returns a 4xx error and is never silently replaced. The selected provider remains fixed for task retries, and billing uses that provider route’s endpoint price. Omit provider to return to Automatic routing. JavaScript:

await sunra.subscribe("google/gemini-2.5-flash-image/text-to-image", {
  input: { prompt: "a cinematic sunrise over a quiet harbor" },
  provider: { only: ["fal"] },
})

Python:

client.submit(
    "google/gemini-2.5-flash-image",
    {"prompt": "a cinematic sunrise over a quiet harbor"},
    path="text-to-image",
    provider={"only": ["fal"]},
)

Legacy compatibility

Provider-specific model URLs remain callable for existing integrations, but no longer appear in the public model catalog. Their URL, input schema, response, fixed provider mapping, task lookup, pricing, and prediction identity are unchanged. A legacy URL cannot be switched to another provider. New integrations should use the canonical model in the right-hand column.

Legacy model URL	Canonical model for new integrations
`openai/gpt-image-2-azure`	`openai/gpt-image-2`
`openai/gpt-image-2-reverse`	`openai/gpt-image-2`
`midjourney/v7-reverse`	`midjourney/v7`
`midjourney/v8.1-reverse`	`midjourney/v8.1`
`kling/kling-v3-4k-fal`	`kling/kling-v3-4k`
`kling/kling-v3-omni-4k-fal`	`kling/kling-v3-omni-4k`
`bytedance/seedance-2.0-relay`	`bytedance/seedance-2.0`
`bytedance/seedance-2.0-fast-relay`	`bytedance/seedance-2.0-fast`
`google/gemini-2.5-flash-image-preview-fal`	`google/gemini-2.5-flash-image`
`google/gemini-2.5-flash-image-preview-relay`	`google/gemini-2.5-flash-image`
`google/gemini-3-pro-image-preview-fal`	`google/gemini-3-pro-image-preview`
`google/gemini-3-pro-image-preview-relay`	`google/gemini-3-pro-image-preview`
`google/gemini-3.1-flash-image-preview-fal`	`google/gemini-3.1-flash-image-preview`
`google/gemini-3.1-flash-image-preview-relay`	`google/gemini-3.1-flash-image-preview`
`google/veo3-1-fal`	`google/veo3-1`
`google/veo3-1-fast-fal`	`google/veo3-1-fast`
`google/veo3-1-lite-fal`	`google/veo3-1-lite`

If a legacy endpoint exposes provider-specific capabilities, you may keep using that legacy URL. Compatibility does not redirect the request to the canonical model.

Overview

Platform

Multimodal

LLM

Client Libraries

Canonical Model Endpoints

Canonical model endpoints

Provider routing

Legacy compatibility

​Canonical model endpoints

​Provider routing

​Legacy compatibility

Canonical model endpoints

Provider routing

Legacy compatibility