Developer setup
Create a key, choose a protocol, and connect image generation to your tool or project.
- 01
Create an API key
Create a key for the required model group.
Open dashboard - 02
Choose a protocol
Prefer Studio Unified for new work; retain a native SDK when it already fits.
Compare protocols - 03
Configure and send
Copy the Base URL, model name, and an example in your language.
Open protocol docs
Address and authentication
https://api.1route.devFrequent timeouts? Use https://image-api.1route.dev| Setting | Value |
|---|---|
| API key | Create it in the main site's dashboard |
| Studio Unified | Use the service origin; prefix models with openai/ or google/ |
| OpenAI SDK | Set base_url to the origin plus /v1, such as https://api.1route.dev/v1 |
| Google Gen AI SDK | Set the origin as Base URL and use API version v1beta |
HTTP examples use Authorization: Bearer YOUR_API_KEY. Google's SDK uses x-goog-api-key. Use a key from the appropriate model group.
OpenAPI integration
When calling the Studio HTTP API directly, ask your AI to read this OpenAPI document or import it into a tool that supports OpenAPI to inspect endpoints, request fields, and response schemas. Use it with the Studio guide for model extensions and the asynchronous job workflow when generating integration code.
Choose a model
🎨 GPT Image options are gpt-image-2, gpt-image-2.5-flare, and gpt-image-2.5-sunburst. Google options are gemini-3.1-flash-image (🍌 Nano Banana 2) and gemini-3-pro-image (🍌 Nano Banana Pro). See model comparison.
For example, use openai/gpt-image-2.5-flare in Studio Unified and gpt-image-2.5-flare in OpenAI Images.
Make a first request
- Open the protocol page and copy an example in your language.
- Start with a short text-to-image prompt, then add references and parameters.
- For Studio Unified, wait for
completedbefore retrieving the result. Native protocols return images directly. - Save the image to your own storage. Server-hosted image URLs and job results are retained for 72 hours.
Choose a protocol · Studio Unified · OpenAI Images · Gemini Native