للمطورين · API v1

API واحدة.
كل النماذج.

صور وفيديو وصوت وثلاثي الأبعاد خلف واجهة API واحدة، بنفس رصيد الاستوديو. أنشئ مفتاحًا من الإعدادات؛ أداة CLI قادمة قريبًا.

قريبًاأداة Opencran CLI في الطريق. تعرض هذه الصفحة كيف ستعمل؛ وحتى ذلك الحين استخدم واجهة API.

$npm i -g @opencran/cli
النماذج
682
نقاط النهاية
9
الحد الأدنى للشحن
‏3 €
01 · أمثلة

الاستدعاء نفسه، أي مخرجات

غيّر معرّف النموذج للتبديل بين الصورة والفيديو والكلام. الحقول تتبع النموذج.

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()));
مثال على التوليدluma/uni-v1/text-to-image
02 · بدء سريع

أول عملية توليد في ثلاث خطوات

  1. 01أنشئ مفتاح APIسجّل الدخول ببريدك الإلكتروني، وافتح الإعدادات ثم مفاتيح API وأنشئ مفتاحًا. اشحن رصيدك بدءًا من ‏3 € في صفحة الفواتير.export OPENCRAN_API_KEY="oc_live_..."
  2. 02CLI قادمة قريبًاقريبًاأداة سطر الأوامر لم تُنشر بعد. حتى ذلك الحين يعمل كل شيء في الاستوديو.
  3. 03نفّذ أول عملية توليداختر معرّف نموذج من الكتالوج وأرسل وصفًا. أضف --dry-run لمعرفة السعر دون إنفاق أي شيء.opencran run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLIقريبًا

التوليد من الطرفية

شغّل أي نموذج من shell أو مهمة CI أو وكيل برمجة. يُحدَّد سعر كل عملية توليد قبل بدئها ويُخصم من الرصيد نفسه.

السكربتات وCIكل حقل في النموذج خيار سطر أوامر، ويُرفع الملف المحلي نيابةً عنك.
JSON على stdoutمستند JSON واحد لكل تشغيل، والتقدم والأخطاء على stderr، ورمز خروج غير صفري عند الفشل.
وكلاء البرمجةملف مهارة يعلّم وكيلك أن يتحقق من السعر أولًا وأن يضع له حدًا.
دليل CLI الكامل →
الأمرما يفعله
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
04 · أساسيات API

مصممة للإنتاج

المصادقة

رمز 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" }
05 · المرجع

نقاط النهاية

عنوان URL الأساسي https://opencran.com/api/v1

مرجع API الكامل →
GET/api/catalog/meمفتاحك ورصيدك
GET/api/catalog/modelsكل النماذج
GET/api/catalog/models/detail?id=MODEL_IDنموذج واحد وحقوله
POST/api/catalog/quoteالسعر لمدخلات محددة
POST/api/catalog/generationsبدء التوليد
GET/api/catalog/generationsعمليات التوليد الأخيرة
GET/api/catalog/generations/IDحالة عملية توليد واحدة
GET/api/catalog/generations/ID/contentملف النتيجة
DELETE/api/catalog/generations/IDحذف عملية توليد

اشحن ‏3 € وانطلق اليوم

أنشئ مفتاح API من الإعدادات واستدعِ أي نموذج. أداة CLI قادمة قريبًا. تُسترد العمليات الفاشلة.