OkayPic API Documentation

Submit an image generation task with an image model (see Image Models). Body fields: model, prompt, ratio, resolution (models that list resolutions), and images — an array of reference images (public https URLs or base64 data URIs). Some models answer immediately with "status": "completed" and resultUrls; otherwise poll GET /api/image/tasks/{taskId}.

curl -X POST https://api.okaypic.com/api/image/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3.1-flash-image-preview", "prompt": "A red fox in the snow", "ratio": "1:1"}'

Response

{
  "generationId": "…",
  "taskId": "…",
  "status": "pending"            // or "completed" with "resultUrls": ["https://…"]
}

Idempotency (safe retries)

Both generate endpoints accept a client-chosen unique id per task, either as the Idempotency-Key header or as client_request_id in the JSON body (the header wins if both are set; 1–255 characters, scoped to your account).

• Resubmitting with a key that already created a task does not create or charge a new one — you get the original taskId and its current status, with "idempotentReplay": true. Keep polling that task.
• If the first request is still being processed, a concurrent retry gets 409 — wait a few seconds and retry with the same key.
• If a request failed before a task was created (4xx/5xx from the generate call), the key is not used up — retry with the same key.
• If the task itself failed (status: "failed", refunded), the same key keeps returning that failed task. To generate again, use a new key.
• A replay returns the original task even if the retry body differs — use a new key for a different request.

curl -X POST https://api.okaypic.com/api/video/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: 541913da-s01_depot_daily_alert-clip1" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax-h3", "prompt": "…", "duration": 5}'

# Same request again (e.g. after a timeout on your side) →
# { "generationId": "3f6c…", "taskId": "3f6c…", "status": "processing", "idempotentReplay": true }

Reference media

Reference files go in media[].url (video endpoint) or images[] (image endpoint), in one of two forms:

• Public URL — must be https:// and reachable from the internet (no login, no expiring link shorter than an hour). Required for videos.
• Inline base64 — a data URI such as data:image/png;base64,iVBORw0…. Images (jpeg / png / webp) and audio only, ≤ 10 MB each, up to 12 per request, request body ≤ 40 MB. Inline files are kept only for generations that were actually created.

import base64, requests

with open("cat.jpg", "rb") as f:
    cat = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()

requests.post("https://api.okaypic.com/api/video/generate",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "minimax-h3",
        "prompt": "<Picture 1> The cat jumps onto the sofa",
        "duration": 5,
        "resolution": "768p",
        "media": [{"type": "image", "url": cat}],
    })