Reve Text-to-Image API

pythonimport os, time, requests

KEY = os.environ["SKILLBOSS_WHOLESALE_KEY"]
HEAD = {"Authorization": f"Bearer {KEY}"}

# 1) Submit the job — async + poll is the only reliable pattern for image gen.
start = requests.post(
    "https://api.skillboss.co/v1/run",
    headers={**HEAD, "Content-Type": "application/json"},
    json={
        "model": "reve/text-to-image",
        "async": True,
        "inputs": {
            "prompt": "A premium commercial advertising photo of a coffee cup, studio lighting, white background",
            "size": "1024x1024",
            "output_format": "png",
        },
    },
    timeout=30,
).json()

status_url = start["status_url"]

# 2) Poll until COMPLETED (or FAILED). Image gen is 10-60s for NB Pro, faster
#    for flash models. A 5-minute ceiling is generous; hit FAILED earlier if
#    upstream rejects the prompt or a reference URL.
deadline = time.time() + 300
while time.time() < deadline:
    poll = requests.get(status_url, headers=HEAD, timeout=30).json()
    if poll["status"] == "COMPLETED":
        # generated_images[] holds short R2 URLs (assets.skillboss.co/*), not
        # signed URLs — they don't expire and can be embedded directly.
        print(poll["result"]["generated_images"][0])
        break
    if poll["status"] == "FAILED":
        raise RuntimeError(poll.get("error", "image gen failed"))
    time.sleep(3)

typescriptconst KEY = process.env.SKILLBOSS_WHOLESALE_KEY
const head = { Authorization: `Bearer ${KEY}` }

// 1) Submit the job — async + poll is the only reliable pattern for image gen.
const start = await fetch("https://api.skillboss.co/v1/run", {
  method: "POST",
  headers: { ...head, "Content-Type": "application/json" },
  body: JSON.stringify({
    model: "reve/text-to-image",
    async: true,
    inputs: {
      prompt: "A premium commercial advertising photo of a coffee cup, studio lighting, white background",
      size: "1024x1024",
      output_format: "png",
    },
  }),
}).then((r) => r.json())

// 2) Poll until COMPLETED (or FAILED). Image gen is 10-60s for NB Pro, faster
//    for flash models. A 5-minute ceiling is generous; hit FAILED earlier if
//    upstream rejects the prompt or a reference URL.
const deadline = Date.now() + 5 * 60_000
while (Date.now() < deadline) {
  const poll = await fetch(start.status_url, { headers: head }).then((r) => r.json())
  if (poll.status === "COMPLETED") {
    // generated_images[] holds short R2 URLs (assets.skillboss.co/*), not
    // signed URLs — they don't expire and can be embedded directly.
    console.log(poll.result.generated_images[0])
    break
  }
  if (poll.status === "FAILED") {
    throw new Error(poll.error ?? "image gen failed")
  }
  await new Promise((r) => setTimeout(r, 3000))
}

bashcurl -X POST https://api.skillboss.co/v1/run \
  -H "Authorization: Bearer $SKILLBOSS_WHOLESALE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "reve/text-to-image",
    "inputs": { "prompt": "your prompt here" },
    "async": true
  }'

json{
  "request_id": "c546520207fb4b68b0adce825f9dcf6d",
  "status": "IN_QUEUE",
  "status_url": "https://api.skillboss.co/v1/run/status/c546520207fb4b68b0adce825f9dcf6d",
  "cancel_url": "https://api.skillboss.co/v1/run/cancel/c546520207fb4b68b0adce825f9dcf6d"
}

bashcurl https://api.skillboss.co/v1/run/status/{request_id} \
  -H "Authorization: Bearer $SKILLBOSS_WHOLESALE_KEY"

bashcurl -X POST https://api.skillboss.co/v1/run/cancel/{request_id} \
  -H "Authorization: Bearer $SKILLBOSS_WHOLESALE_KEY"

json// On success (COMPLETED → status "OK")
{
  "request_id": "c546...",
  "status": "OK",
  "payload": { "generated_images": [{ "url": "https://..." }] },
  "error": null
}

// On failure (FAILED → status "ERROR")
{
  "request_id": "c546...",
  "status": "ERROR",
  "payload": null,
  "error": "<error description>"
}