> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Canonical Model Endpoints

> Use stable, provider-independent model URLs for image and video generation while keeping older provider-specific URLs compatible.

# Canonical model endpoints

Use a model's provider-independent URL in new integrations. Sunra selects the model's default provider without requiring a provider selector:

```
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:

```bash theme={null}
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.

## Legacy compatibility

Provider-specific model URLs remain callable for existing integrations, but no longer appear in the public model catalog. Their URL, input schema, provider, pricing, and prediction identity are unchanged. 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.