Clifzo API 文档

{
  "job_id": "019a0000-0000-7000-8000-000000000001",
  "status": "cancelled",
  "request_id": "req_example"
}

{
  "result": {
    "collection": {
      "items": [
        {
          "id": "work_example",
          "title": "Example public work",
          "thumbnail_url": null,
          "webpage_url": "https://www.youtube.com/watch?v=VbDupSuRf_Q"
        }
      ],
      "truncated": false
    }
  }
}

// Node.js 22+; set these variables on your server.
const base = new URL(process.env.CLIFZO_API_BASE || 'https://YOUR_API_HOST').origin;
const key = process.env.CLIFZO_API_KEY;
const requestId = process.env.CLIFZO_REQUEST_ID; // persisted per logical task
if (!key || !requestId) throw new Error('Set API key and stable request ID');
async function call(path, body) {
  const response = await fetch(base + path, {
    method: body ? 'POST' : 'GET',
    headers: { Authorization: 'Bearer ' + key,
      ...(body ? { 'Content-Type': 'application/json',
        'Idempotency-Key': requestId } : {}) },
    body: body ? JSON.stringify(body) : undefined,
    redirect: 'error', signal: AbortSignal.timeout(15000),
  });
  const data = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(data.error));
  return data;
}
const job = await call('/v1/api/jobs', {
  url: 'https://www.youtube.com/watch?v=VbDupSuRf_Q', action: 'resolve',
});
for (let attempt = 0; attempt < 60; attempt++) {
  await new Promise(resolve => setTimeout(resolve, 3000));
  const task = await call('/v1/api/jobs/' + encodeURIComponent(job.job_id));
  if (task.status === 'succeeded') { console.log(task.result); break; }
  if (['failed', 'cancelled', 'expired'].includes(task.status)) {
    throw new Error(JSON.stringify({ job_id: task.id,
      error: task.error, request_id: task.request_id }));
  }
  if (attempt === 59) throw new Error('Polling budget exhausted; resume this job later');
}

# Python 3; environment variables are kept on your server.
import json, os, time
from urllib.request import Request, build_opener, HTTPRedirectHandler

base = os.environ.get('CLIFZO_API_BASE', 'https://YOUR_API_HOST').rstrip('/')
key = os.environ['CLIFZO_API_KEY']
request_id = os.environ['CLIFZO_REQUEST_ID']  # persisted per logical task

class NoRedirect(HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

client = build_opener(NoRedirect)
def call(path, body=None):
    headers = {'Authorization': 'Bearer ' + key}
    data = None
    if body is not None:
        headers.update({'Content-Type': 'application/json',
                        'Idempotency-Key': request_id})
        data = json.dumps(body).encode()
    with client.open(Request(base + path, data=data, headers=headers),
                     timeout=15) as response:
        return json.load(response)

job = call('/v1/api/jobs', {'url': 'https://www.youtube.com/watch?v=VbDupSuRf_Q', 'action': 'resolve'})
for attempt in range(60):
    time.sleep(3)
    task = call('/v1/api/jobs/' + job['job_id'])
    if task['status'] == 'succeeded':
        print(json.dumps(task['result'], ensure_ascii=False))
        break
    if task['status'] in ('failed', 'cancelled', 'expired'):
        raise RuntimeError({'job_id': job['job_id'], 'error': task.get('error'),
                            'request_id': task.get('request_id')})
else:
    raise TimeoutError('Polling budget exhausted; resume this job later')

{
  "account_id": "account_example",
  "available_credits": 99,
  "frozen_credits": 0,
  "pricing": {
    "single": 1,
    "profile": 2
  }
}

{
  "items": [
    {
      "id": "ledger_example",
      "account_id": "account_example",
      "kind": "consume",
      "amount": -1,
      "available_credits": 99,
      "frozen_credits": 0,
      "reason": "Parse succeeded",
      "actor": "system",
      "job_id": "019a0000-0000-7000-8000-000000000001",
      "order_id": null,
      "created_at_ms": 1792656000000
    }
  ],
  "limit": 50,
  "offset": 0
}