Universal Image API

Unified API for multiple image generation and image editing models

API Overview

To simplify the integration of different image generation models、image editing models, OneRouter provides a unified image API.

API Specification

image generation models

Curl

curl https://image.onerouter.pro/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: <API_KEY>" \
    -d '{
    "model": "gpt-image-1",
    "prompt": "A cute baby sea otter",
    "n": 1,
    "output_format": "url"
  }'

Python

• https://image.onerouter.pro/v1/images/generations is the base URL

• <API_KEY> is your API Key generated in API page.

• model is the model name, such as gpt-image-1, available model list can be access in Model page.

• prompt is the prompt.

• n is the number of images to generate, default value is 1.

• output_format indicate the output format, default value is url.

  • b64_json

  • url

Example response

{
    "data": [
        {
            "url": "https://resource.trustai.sg/image/generated%2Fonerouter_a146ee8a-1fe2-43ce-803a-fb1e7f3f6949.png",
            "b64_json": "",
            "revised_prompt": ""
        }
    ],
    "created": 1760177063
}

image editing models

Curl

curl https://image.onerouter.pro/v1/images/edits \
    -H "Content-Type: application/json" \
    -H "Authorization: <API_KEY>" \
    --data-raw '{
    "model": "dreamomni2-image-to-image",
    "prompt": "Replace the first image have the same image style as the second image.",
    "image_urls": [
        "https://resource.trustai.sg/image/generated%2Fonerouter_a146ee8a-1fe2-43ce-803a-fb1e7f3f6949.png",
        "https://resource.onerouter.pro/image/generated%2Fonerouter_fe4771ae-d67c-41bb-a366-b07f1411ae06.png"
    ],
    "n": 1,
    "output_format": "url"
}'

• https://image.onerouter.pro/v1/images/edits is the base URL

• <API_KEY> is your API Key generated in API page.

• model is the model name, such as dreamomni2-image-to-image, available model list can be access in Model page.

• prompt is the prompt.

• image_urls is the list of URLs of input images for editing.

• n is the number of images to generate, default value is 1.

• output_format indicate the output format, default value is url.

  • b64_json

  • url

Example response

{
    "data": [
        {
            "url": "https://resource.trustai.sg/image/generated%2Fonerouter_a146ee8a-1fe2-43ce-803a-fb1e7f3f6949.png",
            "b64_json": "",
            "revised_prompt": ""
        }
    ],
    "created": 1760177063
}