> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Venice API
> وثائق Venice API — وصول خاص وغير مُقيَّد إلى نماذج الدردشة والصور والصوت والفيديو المتوافقة مع OpenAI خلف مفتاح API واحد.
واجهة برمجة التطبيقات للوصول الخاص وغير المُقيَّد إلى الذكاء.
محادثة وصورة وصوت وفيديو متوافقة مع OpenAI خلف مفتاح API واحد.
```bash curl theme={null}
curl https://api.venice.ai/api/v1/chat/completions \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org-glm-5-1",
"messages": [{"role": "user", "content": "Build without permission."}]
}'
```
```ts TypeScript theme={null}
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.VENICE_API_KEY,
baseURL: "https://api.venice.ai/api/v1",
});
const res = await client.chat.completions.create({
model: "zai-org-glm-5-1",
messages: [{ role: "user", content: "Build without permission." }],
});
```
```python Python theme={null}
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["VENICE_API_KEY"],
base_url="https://api.venice.ai/api/v1",
)
res = client.chat.completions.create(
model="zai-org-glm-5-1",
messages=[{"role": "user", "content": "Build without permission."}],
)
```
نقاط النهاية
واجهة واحدة لكل وسيلة
محادثة وصورة وصوت وفيديو وتضمينات خلف مفتاح API واحد.
بالإضافة إلى التضمينات، وإدخالات الملفات، وأدوات MCP، والمدفوعات عبر المحفظة. عرض كل نقاط النهاية ←
الوكلاء
مبنية لوكلاء الذكاء الاصطناعي
استدلال خاص، وأدوات MCP، وتدفقات عمل مموّلة من المحفظة للمراسلة والبرمجة والوكلاء داخل السلسلة.
استكشف مركز وكلاء الذكاء الاصطناعي ←
النماذج
نماذج شائعة
بعض أكثر النماذج استخدامًا على Venice. استخدم المعرّف كقيمة لمعامل `model`.
أكثر من 250 نموذجًا
نص وصورة وصوت وفيديو
تصفّح الكتالوج ←
الأدوات
أدوات مدمجة لنماذج المحادثة
شغّل البحث في الويب، أرفق ملفات، أو استعلم سلسلة بلوكتشين عبر `venice_parameters` أو نقطة نهاية أصلية في Venice.
أضف بحثًا في الويب في الوقت الفعلي مع استشهادات لأي نموذج نصي عبر `enable_web_search`.
```bash Curl theme={null}
curl https://api.venice.ai/api/v1/chat/completions \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org-glm-5-1",
"messages": [{"role": "user", "content": "What are the latest developments in AI?"}],
"venice_parameters": {
"enable_web_search": "auto"
}
}'
```
```ts TypeScript theme={null}
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.VENICE_API_KEY!,
baseURL: "https://api.venice.ai/api/v1",
});
const completion = await client.chat.completions.create({
model: "zai-org-glm-5-1",
messages: [{ role: "user", content: "What are the latest developments in AI?" }],
// @ts-expect-error - Venice-specific parameter
venice_parameters: {
enable_web_search: "auto",
},
});
console.log(completion.choices[0].message.content);
```
```python Python theme={null}
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["VENICE_API_KEY"],
base_url="https://api.venice.ai/api/v1",
)
response = client.chat.completions.create(
model="zai-org-glm-5-1",
messages=[{"role": "user", "content": "What are the latest developments in AI?"}],
extra_body={
"venice_parameters": {
"enable_web_search": "auto",
}
},
)
print(response.choices[0].message.content)
```
```bash Model Suffix theme={null}
# بديل: ألحق المعاملات مباشرة بمعرّف النموذج
curl https://api.venice.ai/api/v1/chat/completions \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org-glm-5-1:enable_web_search=on&enable_web_citations=true",
"messages": [{"role": "user", "content": "What are the latest developments in AI?"}]
}'
```
عيّن `enable_web_scraping: true` وسيقوم النموذج بجلب وقراءة أي روابط في رسالة المستخدم قبل الإجابة.
```bash Curl theme={null}
curl https://api.venice.ai/api/v1/chat/completions \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai-gpt-55",
"messages": [
{"role": "user", "content": "Summarize this post in five bullets: https://venice.ai/blog/how-to-use-venice-api"}
],
"venice_parameters": {
"enable_web_scraping": true
}
}'
```
```ts TypeScript theme={null}
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.VENICE_API_KEY!,
baseURL: "https://api.venice.ai/api/v1",
});
const response = await client.chat.completions.create({
model: "openai-gpt-55",
messages: [
{
role: "user",
content:
"Summarize this post in five bullets: https://venice.ai/blog/how-to-use-venice-api",
},
],
// @ts-expect-error - Venice-specific parameter
venice_parameters: {
enable_web_scraping: true,
},
});
console.log(response.choices[0].message.content);
```
```python Python theme={null}
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["VENICE_API_KEY"],
base_url="https://api.venice.ai/api/v1",
)
response = client.chat.completions.create(
model="openai-gpt-55",
messages=[
{
"role": "user",
"content": "Summarize this post in five bullets: https://venice.ai/blog/how-to-use-venice-api",
}
],
extra_body={
"venice_parameters": {
"enable_web_scraping": True,
}
},
)
print(response.choices[0].message.content)
```
أرفق ملفات PDF ومستندات Office وشيفرات وملفات نصية (حتى 25 ميغابايت) مباشرة في طلب محادثة. راجع [دليل إدخالات الملفات](/guides/features/file-inputs) للحصول على القائمة الكاملة للصيغ.
```bash Curl theme={null}
# رمّز ملفًا محليًا كرابط بيانات base64، ثم أرسله مضمَّنًا
FILE_B64=$(base64 q3-report.pdf | tr -d '\n')
curl https://api.venice.ai/api/v1/chat/completions \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d "{
\"model\": \"openai-gpt-55\",
\"messages\": [
{
\"role\": \"user\",
\"content\": [
{\"type\": \"text\", \"text\": \"Summarize this report in five bullets and list the main risks.\"},
{\"type\": \"file\", \"file\": {\"filename\": \"q3-report.pdf\", \"file_data\": \"data:application/pdf;base64,${FILE_B64}\"}}
]
}
]
}"
```
```ts TypeScript theme={null}
import OpenAI from "openai";
import { readFile } from "node:fs/promises";
const client = new OpenAI({
apiKey: process.env.VENICE_API_KEY!,
baseURL: "https://api.venice.ai/api/v1",
});
const pdf = await readFile("q3-report.pdf");
const fileData = `data:application/pdf;base64,${pdf.toString("base64")}`;
const response = await client.chat.completions.create({
model: "openai-gpt-55",
messages: [
{
role: "user",
content: [
{ type: "text", text: "Summarize this report in five bullets and list the main risks." },
// @ts-expect-error - Venice file input block
{ type: "file", file: { filename: "q3-report.pdf", file_data: fileData } },
],
},
],
});
console.log(response.choices[0].message.content);
```
```python Python theme={null}
import base64
import os
from pathlib import Path
from openai import OpenAI
client = OpenAI(
api_key=os.environ["VENICE_API_KEY"],
base_url="https://api.venice.ai/api/v1",
)
path = Path("q3-report.pdf")
file_data = "data:application/pdf;base64," + base64.b64encode(path.read_bytes()).decode("utf-8")
response = client.chat.completions.create(
model="openai-gpt-55",
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "Summarize this report in five bullets and list the main risks."},
{"type": "file", "file": {"filename": "q3-report.pdf", "file_data": file_data}},
],
}
],
)
print(response.choices[0].message.content)
```
وكّل استدعاءات JSON-RPC 2.0 عبر 11 سلسلة مدعومة بمفتاح Venice الخاص بك أو محفظة x402. راجع [مرجع Crypto RPC](/api-reference/endpoint/crypto/rpc) للسلاسل والطرق وفئات الأرصدة.
```bash Curl theme={null}
curl https://api.venice.ai/api/v1/crypto/rpc/ethereum-mainnet \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": [],
"id": 1
}'
```
```ts TypeScript theme={null}
const response = await fetch(
"https://api.venice.ai/api/v1/crypto/rpc/base-mainnet",
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify([
{ jsonrpc: "2.0", method: "eth_chainId", params: [], id: 1 },
{ jsonrpc: "2.0", method: "eth_blockNumber", params: [], id: 2 },
]),
}
);
const results = await response.json();
console.log(results);
```
```python Python theme={null}
import os
import requests
response = requests.post(
"https://api.venice.ai/api/v1/crypto/rpc/ethereum-mainnet",
headers={
"Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
"Content-Type": "application/json",
},
json={
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "latest"],
"id": 1,
},
)
print(response.json())
```
التسعير
اشحن الرصيد، أو راهن، أو ادفع لكل طلب
موّل حسابًا بأرصدة، أو راهن DIEM لمخصصات يومية، أو تخطّ الحساب بالكامل بـ USDC على Base.
الأرصدة (Credits)
USD أو عملة مشفّرة
ادفع حسب الاستخدام بالدولار أو بالعملة المشفّرة. الأرصدة لا تنتهي صلاحيتها وتعمل عبر كل نقاط النهاية.
اشتر أرصدة
DIEM
مخصصات يومية
راهن DIEM أو VVV مرة واحدة واكتسب مخصصات استدلال ثابتة يوميًا، بلا رسوم لكل استدعاء.
تعرّف على DIEM
x402
USDC على Base
ادفع لكل طلب من أي محفظة Base بـ USDC. بلا حساب أو مفتاح API، مبني للوكلاء.
اقرأ دليل x402
أسئلة أو ملاحظات؟ انضم إلينا على [Discord](https://discord.gg/askvenice).