# 1 · reachability — no key needed
curl https://api.perseworks.hk/v1/models

# 2 · your key + balance — the cheapest possible call
curl https://api.perseworks.hk/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"seed-2.0-mini","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

import requests

r = requests.post(
    "https://api.perseworks.hk/v1/chat/completions",
    headers={"Authorization": "Bearer sk-..."},
    json={"model": "seed-2.0-mini",
          "messages": [{"role": "user", "content": "ping"}],
          "max_tokens": 16},
)
print(r.status_code, r.json())

const r = await fetch("https://api.perseworks.hk/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seed-2.0-mini",
    messages: [{ role: "user", content: "ping" }],
    max_tokens: 16,
  }),
});
console.log(r.status, await r.json());

curl https://api.perseworks.hk/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"seed-2.0-mini","messages":[{"role":"user","content":"ping"}]}'

import requests

r = requests.post(
    "https://api.perseworks.hk/v1/chat/completions",
    headers={"Authorization": "Bearer sk-..."},
    json={"model": "seed-2.0-mini",
          "messages": [{"role": "user", "content": "ping"}]},
)
print(r.status_code, r.json())

const r = await fetch("https://api.perseworks.hk/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seed-2.0-mini",
    messages: [{ role: "user", content: "ping" }],
  }),
});
console.log(r.status, await r.json());

curl https://api.perseworks.hk/v1/video/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f1d6c1e-9b0a-4c36-8d1e-2a7f3c9b4e10" \
  -d '{"model":"seedance-2.0-fast","prompt":"a cat surfing a wave, cinematic","resolution":"720p","durationSec":5}'

import uuid, requests

key = str(uuid.uuid4())  # generate once, reuse on every retry
r = requests.post(
    "https://api.perseworks.hk/v1/video/generations",
    headers={"Authorization": "Bearer sk-...", "Idempotency-Key": key},
    json={"model": "seedance-2.0-fast", "prompt": "a cat surfing a wave, cinematic",
          "resolution": "720p", "durationSec": 5},
)

const key = crypto.randomUUID(); // generate once, reuse on every retry
await fetch("https://api.perseworks.hk/v1/video/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-...",
    "Content-Type": "application/json",
    "Idempotency-Key": key,
  },
  body: JSON.stringify({ model: "seedance-2.0-fast", prompt: "a cat surfing a wave, cinematic",
                         resolution: "720p", durationSec: 5 }),
});

curl https://api.perseworks.hk/v1/models

import requests

for m in requests.get("https://api.perseworks.hk/v1/models").json()["data"]:
    print(m["id"], m["category"])

const { data } = await (await fetch("https://api.perseworks.hk/v1/models")).json();
data.forEach((m) => console.log(m.id, m.category));

curl https://api.perseworks.hk/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seed-2.1-pro",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-...", base_url="https://api.perseworks.hk/v1")

stream = client.chat.completions.create(
    model="seed-2.1-pro",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "sk-...", baseURL: "https://api.perseworks.hk/v1" });

const stream = await client.chat.completions.create({
  model: "seed-2.1-pro",
  messages: [{ role: "user", content: "Hello!" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0].delta.content || "");
}

curl https://api.perseworks.hk/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seed-2.1-pro",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "What is in this image?"},
        {"type": "image_url", "image_url": {"url": "https://example.com/cat.jpg", "detail": "low"}}
      ]
    }]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-...", base_url="https://api.perseworks.hk/v1")

r = client.chat.completions.create(
    model="seed-2.1-pro",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "What is in this image?"},
            {"type": "image_url",
             "image_url": {"url": "https://example.com/cat.jpg", "detail": "low"}},
        ],
    }],
)
print(r.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "sk-...", baseURL: "https://api.perseworks.hk/v1" });

const r = await client.chat.completions.create({
  model: "seed-2.1-pro",
  messages: [{
    role: "user",
    content: [
      { type: "text", text: "What is in this image?" },
      { type: "image_url",
        image_url: { url: "https://example.com/cat.jpg", detail: "low" } },
    ],
  }],
});
console.log(r.choices[0].message.content);

curl https://api.perseworks.hk/v1/images/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  --max-time 150 \
  -d '{
    "model": "seedream-5.0",
    "prompt": "a red panda barista, cinematic lighting",
    "size": "2K"
  }'

import requests

r = requests.post(
    "https://api.perseworks.hk/v1/images/generations",
    headers={"Authorization": "Bearer sk-..."},
    json={"model": "seedream-5.0",
          "prompt": "a red panda barista, cinematic lighting",
          "size": "2K"},
    timeout=150,  # generation takes ~70–90 s
)
print(r.json()["data"][0]["url"])

const res = await fetch("https://api.perseworks.hk/v1/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedream-5.0",
    prompt: "a red panda barista, cinematic lighting",
    size: "2K",
  }),
  signal: AbortSignal.timeout(150_000), // generation takes ~70–90 s
});
console.log((await res.json()).data[0].url);

curl https://api.perseworks.hk/v1/video/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "a cat surfing a wave, cinematic",
    "resolution": "1080p",
    "durationSec": 5,
    "aspectRatio": "16:9"
  }'

import requests

r = requests.post(
    "https://api.perseworks.hk/v1/video/generations",
    headers={"Authorization": "Bearer sk-..."},
    json={
        "model": "seedance-2.0",
        "prompt": "a cat surfing a wave, cinematic",
        "resolution": "1080p",
        "durationSec": 5,
        "aspectRatio": "16:9",
    },
)
task = r.json()
print(task["id"], task["status"])  # vid_...  queued

const res = await fetch("https://api.perseworks.hk/v1/video/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.0",
    prompt: "a cat surfing a wave, cinematic",
    resolution: "1080p",
    durationSec: 5,
    aspectRatio: "16:9",
  }),
});
const task = await res.json();
console.log(task.id, task.status); // vid_...  queued

curl https://api.perseworks.hk/v1/video/generations/vid_8KqZ2mR4tY7wP1xN \
  -H "Authorization: Bearer sk-..."

import time, requests

while True:
    t = requests.get(
        f"https://api.perseworks.hk/v1/video/generations/{task_id}",
        headers={"Authorization": "Bearer sk-..."},
    ).json()
    if t["status"] in ("succeeded", "failed"):
        break
    time.sleep(10)
print(t.get("video_url") or t["error"])

let t;
do {
  await new Promise((r) => setTimeout(r, 10_000));
  t = await (await fetch(`https://api.perseworks.hk/v1/video/generations/${taskId}`, {
    headers: { "Authorization": "Bearer sk-..." },
  })).json();
} while (t.status === "queued" || t.status === "running");
console.log(t.video_url ?? t.error);