Quickstart

# 1. Download the task
curl https://api.aicmelabs.com/v1/tasks/aicme/example-001/versions/tv_3f9a1c07b2e45d18/package \
  -H "Authorization: Bearer your-api-key" \
  -o package.tar

# 2. Send an answer
curl -X POST https://api.aicmelabs.com/v1/rewards \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"task": {"id": "aicme/example-001", "version": "tv_3f9a1c07b2e45d18"}, "answer": "Your final answer here"}'

# 3. Get the reward, with the id from step 2. Repeat every 5 seconds while status is "pending"
curl https://api.aicmelabs.com/v1/rewards/REWARD_ID \
  -H "Authorization: Bearer your-api-key"

import time

import httpx

API_KEY = "your-api-key"
BASE = "https://api.aicmelabs.com"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}


def download(task_id: str, version: str) -> bytes:
    r = httpx.get(f"{BASE}/v1/tasks/{task_id}/versions/{version}/package", headers=HEADERS, timeout=60)
    r.raise_for_status()
    return r.content


def get_reward(task_id: str, version: str, answer: str) -> dict:
    task = {"id": task_id, "version": version}
    sent = httpx.post(f"{BASE}/v1/rewards", headers=HEADERS, json={"task": task, "answer": answer})
    sent.raise_for_status()
    reward_id = sent.json()["id"]

    while True:
        r = httpx.get(f"{BASE}/v1/rewards/{reward_id}", headers=HEADERS)
        r.raise_for_status()
        reward = r.json()
        if reward["status"] != "pending":
            return reward
        time.sleep(5)


with open("package.tar", "wb") as f:
    f.write(download("aicme/example-001", "tv_3f9a1c07b2e45d18"))

reward = get_reward("aicme/example-001", "tv_3f9a1c07b2e45d18", "Your final answer here")
print(reward["scores"])

const API_KEY = "your-api-key";
const BASE = "https://api.aicmelabs.com";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

async function getReward(taskId: string, version: string, answer: string) {
  const sent = await fetch(`${BASE}/v1/rewards`, {
    method: "POST",
    headers: { ...HEADERS, "Content-Type": "application/json" },
    body: JSON.stringify({ task: { id: taskId, version }, answer }),
  });
  if (!sent.ok) throw new Error(await sent.text());
  const { id } = await sent.json();

  while (true) {
    const r = await fetch(`${BASE}/v1/rewards/${id}`, { headers: HEADERS });
    if (!r.ok) throw new Error(await r.text());
    const reward = await r.json();
    if (reward.status !== "pending") return reward;
    await new Promise((res) => setTimeout(res, 5000));
  }
}

const reward = await getReward("aicme/example-001", "tv_3f9a1c07b2e45d18", "Your final answer here");
console.log(reward.scores);