Image Generation

Overview

Generate images from a text prompt. The request and response shape match OpenAI's images.generate, so any existing OpenAI SDK works by pointing base_url at https://api.callmissed.com/v1.

Endpoint: POST /v1/images/generations

Images come back as base64-encoded PNG (or JPEG, depending on the model) in the data[].b64_json field, with a short-lived signed data[].url alongside it. Send response_format: "url" to get only the link.

1. 1

   Your app

   Send a , , and to

2. 2

   CallMissed gateway

   Route to the image provider and deduct per-image credits

3. 3

   Image model

   Render the image from your prompt

4. 4

   Your app

   Decode (base64 PNG/JPEG) and save or display it

Basic Usage

from openai import OpenAI

client = OpenAI(
    api_key="cm_your_key",
    base_url="https://api.callmissed.com/v1",
)

res = client.images.generate(
    model="flux-2-klein-9b",
    prompt="A golden retriever in a sunlit library, cinematic bokeh",
    n=1,
    size="1024x1024",
)
# res.data[0].b64_json → base64 image

Parameters

Response

{
  "created": 1731234567,
  "data": [
    { "b64_json": "<base64 PNG>", "url": "https://...signed-url...", "revised_prompt": null }
  ]
}

url is a short-lived signed link — download or re-host it promptly. It is omitted when the image could not be stored, so always fall back to b64_json.

reference_images and reference_pdf work only with gpt-image-2.5-sunburst, gpt-image-2.5-flare, gpt-image-2 and gpt-image-1.5. With any other model the request fails 422 before any credits are reserved, rather than quietly ignoring your references.

Models

Free-plan keys can call the six Free rows. Every Paid row needs Starter or above; a free key gets 403 model_not_available. flux-1.1-pro is currently under maintenance and returns 503 model_under_maintenance — use flux-2-pro or gpt-image-2.

Availability fallback

If the model you asked for fails with a temporary upstream error, the request may be served by a similar fallback model instead of failing (for example gpt-image-2 → gpt-image-1.5). A fallback is only used when your plan and the key's allowed_models permit it, never for a model under maintenance, and only with models that can honour reference_images when you sent them. You are never charged more than the price of the model you asked for: if a cheaper model served, the difference is refunded. The served model is recorded in your usage logs. Errors caused by the request itself (a content policy refusal, a bad parameter) never fall back.

Sizes

Common presets: 512x512, 768x768, 1024x1024, 1024x1536, 1536x1024.

Any width/height from 64 to 4096 is accepted, but providers may clamp or round down to their supported values.

Pricing

Flat per-image price, converted to credits at 1 credit = ₹1 ≈ US$0.0104 (US$1 = ₹96).

Prices are for a standard-resolution (1K) image.

Credits for the request are reserved before generation and refunded in full if it fails, so a failed generation costs nothing.

List History

Retrieve images previously generated with your API key, newest first. Useful for galleries and audit trails.

Endpoint: GET /v1/images/history

import requests

resp = requests.get(
    "https://api.callmissed.com/v1/images/history",
    headers={"Authorization": "Bearer cm_your_key"},
    params={"limit": 20},
)
data = resp.json()
for item in data["data"]:
    print(item["id"], item["model"], item["url"])

# Paginate with the returned cursor
if data["next_cursor"]:
    next_page = requests.get(
        "https://api.callmissed.com/v1/images/history",
        headers={"Authorization": "Bearer cm_your_key"},
        params={"limit": 20, "before": data["next_cursor"]},
    ).json()

Response:

{
  "data": [
    {
      "id": "a1b2c3d4-...",
      "url": "https://...signed-url...",
      "model": "nano-banana-pro",
      "size": "1024x1024",
      "prompt": "a red bicycle on a beach",
      "negative_prompt": null,
      "revised_prompt": null,
      "seed": 42,
      "steps": 28,
      "created": 1760000000
    }
  ],
  "next_cursor": "2026-04-12T10:00:00+00:00"
}

url is a short-lived signed link — download or re-host promptly. The API key must have image permission (otherwise 403 permission_denied). next_cursor is null on the last page.

Errors