🖼️ Image Generation - Oxen.ai

Image Generation

Generate an image from a text prompt. To find models, filter the Models page by “Text to image”.

cURL
Python

Start the generation

GEN_ID=$(curl -s -X POST \
  https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
    "model": "gpt-image-2-5-sunburst",
    "prompt": "A majestic ox standing in a field at sunset"
  }' | jq -r '.generations[0].generation_id')

Wait for it to finish

while true; do
  STATUS=$(curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.status')
  case $STATUS in succeeded|failed|cancelled) break;; esac
  sleep 3
done

curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
  "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.result_url'

import os
import requests
import time

HEADERS = {
    "Authorization": f"Bearer {os.getenv('OXEN_API_KEY')}",
    "Content-Type": "application/json",
}

enqueue = requests.post(
    "https://hub.oxen.ai/api/ai/queue",
    headers=HEADERS,
    json={
        "model": "gpt-image-2-5-sunburst",
        "prompt": "A majestic ox standing in a field at sunset",
    },
)
enqueue.raise_for_status()
generation_id = enqueue.json()["generations"][0]["generation_id"]

while True:
    data = requests.get(
        f"https://hub.oxen.ai/api/ai/queue/{generation_id}",
        headers=HEADERS,
    ).json()
    if data["status"] in {"succeeded", "failed", "cancelled"}:
        break
    time.sleep(3)

print(f"Generated image: {data['result_url']}")

Parameters

model: Model name, for example gpt-image-2-5-sunburst
prompt: What to generate
num_generations: Number of images, 1 to 4 (optional, default 1)

Models can take more parameters, listed in each model’s API reference. The queue reference covers the rest of the queue API.