واجهة برمجة تطبيقات Veo 3: الموجّهات والنصوص عبر نقطة نهاية واحدة

المتطلبات المبدئية والمصادقة

قبل إرسال طلبك الأول، تأكد من امتلاكك لمفتاح API صالح. سجّل في صفحة الحصول على مفتاح API باستخدام البريد الإلكتروني وكلمة المرور فقط. تحصل على وصول فوري إلى رصيد تجريبي مجاني بقيمة $0.50 صالح لمدة 7 أيام، دون الحاجة إلى بطاقة ائتمان. للأحمال الإنتاجية، قم بشحن الرصيد بمبلغ لا يقل عن $10 لضمان استمرار الوصول.

عنوان URL الأساسي الخاص بنا هو https://api.veo3apis.com/v1.. قم بتضمين مفتاح API الخاص بك في رأس Authorization كرمز Bearer. هذه النقطة متوافقة تمامًا مع OpenAI، مما يعني أنه يمكنك استخدام واجهات SDK القياسية عن طريق توجيهها إلى عنوان URL الأساسي الخاص بنا.

إكمال المحادثة الأساسي

أرسل طلب POST قياسي إلى /v1/chat/completions لتوليد النص. معرف النموذج هو "uncensored". هذا يعيد الاستجابة الكاملة في كائن JSON واحد، وهو مثالي لتوليد الموجّهات البسيط أو مهام كتابة النصوص حيث لا تحتاج إلى تحديثات في الوقت الفعلي.

تكامل SDK لـ Python

استخدم مكتبة Python الرسمية لـ OpenAI لتكامل نظيف. قم بتكوين العميل باستخدام عنوان URL الأساسي الخاص بنا ومفتاح API الخاص بك. يبسط هذا النهج معالجة الأخطاء وحساب الرموز لخطوط الأنابيب متعددة الوسائط الخاصة بك.

تكامل SDK لـ Node.js

لمشاريع JavaScript/TypeScript، يعمل Node SDK الخاص بـ OpenAI مباشرة. وجّه العميل إلى URL الأساسي الخاص بنا. هذا مفيد لتوليد النصوص على جانب الخادم أو خطوات المعالجة اللاحقة في سير عمل Veo 3 الخاص بك.

الاستجابات المتدفقة (SSE)

لتقليل زمن الاستجابة المُدرَك، فعّل البث المتدفق عن طريق تعيين stream: true. تُعيد واجهة برمجة التطبيقات تدفق أحداث الإرسال (SSE) للاستجابات الجزئية. يتيح ذلك لتطبيقك عرض الرموز (tokens) أثناء توليدها، وهو أمر حاسم لتوليد نصوص طويلة أو مهام الاستدلال المعقدة.

الحدود، والأخطاء، والنافذة السياقية

تخضع طلباتك لحدّ المعدل البالغ 300 طلب في الدقيقة لكل مفتاح API. إذا تجاوزت هذا الحد، ستتلقى خطأ 429. تُعيد أخطاء المصادقة 401، ونقص الرصيد يُعيد 402. تبلغ نافذة السياق 100,000 رمز (token) إجمالاً (الموجّه + الإكمال). تأكد من أن حمولات الطلبات لا تتجاوز 8 MB. الحد الوحيد الصارم للمحتوى هو المحتوى الجنسي الذي يتضمن قاصرين، والذي يتم حظره دائماً.

cURL

Copycurl https://api.veo3apis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.veo3apis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.veo3apis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

البث المتدفق

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)