المصادقة
رمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.
Authorization: Bearer oc_live_...صور وفيديو وصوت وثلاثي الأبعاد خلف واجهة API واحدة، بنفس رصيد الاستوديو. أنشئ مفتاحًا من الإعدادات؛ أداة CLI قادمة قريبًا.
قريبًاأداة Opencran CLI في الطريق. تعرض هذه الصفحة كيف ستعمل؛ وحتى ذلك الحين استخدم واجهة API.
npm i -g @opencran/cliغيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.
1import { writeFile } from "node:fs/promises";2 3const API = "https://opencran.com/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.OPENCRAN_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8 method: "POST",9 headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10 body: JSON.stringify({11 modelId: "luma/uni-v1/text-to-image",12 inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13 }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19 await new Promise((r) => setTimeout(r, 3000));20 ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
export OPENCRAN_API_KEY="oc_live_..."opencran run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.
opencran loginالصق مفتاح API مرة واحدة، فيُتحقق منه ويُحفظopencran whoamiاسم المفتاح ورصيدكopencran models --type videoكل نماذج الفيديو مع سعرها الابتدائيopencran run <model> -hحقول النموذج مباشرة: النوع والقيمة الافتراضية والقيم المسموح بهاopencran run <model> -p "<prompt>" -o ./out/التوليد وحفظ النتيجة في مجلدopencran run <model> -p "..." --dry-runالسعر الدقيق دون إنفاق أي شيءopencran run <model> -p "..." --max-price 0.50رفض التشغيل إذا كان السعر أعلىopencran run <model> -p "..." --json -o ./out/نتيجة JSON واحدة جاهزة للخطوة التاليةopencran skill installعلّم وكيل البرمجة استخدام CLIرمز Bearer في ترويسة Authorization. أنشئ المفاتيح من الإعدادات وألغِ أيًّا منها في أي وقت.
Authorization: Bearer oc_live_...بدء عملية توليد يرد فورًا بالحالة queued. استعلم عنها حتى تنجح أو تفشل أو يُسترد مبلغها.
{ "status": "queued" }اطلب السعر الدقيق لمدخلاتك دون بدء أي شيء. كل المبالغ بسنتات اليورو.
POST /api/v1/api/catalog/quoteأرسل ترويسة Idempotency-Key ولن يُحتسب الطلب المعاد مرتين أبدًا.
Idempotency-Key: render-042لكل مفتاح حد في الدقيقة وسقف يومي اختياري. بعد تجاوز الحد ترد API بالرمز 429.
429 Too Many Requestsأخطاء JSON برمز ورسالة. عملية التوليد التي تفشل يُرد مبلغها إلى رصيدك تلقائيًا.
{ "status": "refunded" }/api/catalog/meمفتاحك ورصيدك/api/catalog/modelsكل النماذج/api/catalog/models/detail?id=MODEL_IDنموذج واحد وحقوله/api/catalog/quoteالسعر لمدخلات محددة/api/catalog/generationsبدء التوليد/api/catalog/generationsعمليات التوليد الأخيرة/api/catalog/generations/IDحالة عملية توليد واحدة/api/catalog/generations/ID/contentملف النتيجة/api/catalog/generations/IDحذف عملية توليداشحن 3 € وانطلق اليوم
أنشئ مفتاح API من الإعدادات واستدعِ أي نموذج. أداة CLI قادمة قريبًا. تُسترد العمليات الفاشلة.