> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-f533effe.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# الانتقال من OpenAI

> انقل تطبيقات OpenAI إلى Venice API عبر تبديل base URL ومفتاح API، مع جدول توافق الميزات لـ chat والصور وembeddings وTTS.

يُعدّ Venice AI **بديلاً جاهزاً (drop-in)** لـ OpenAI. نفس SDK ونفس الكود — ما عليك سوى تغيير سطرين. احصل على استدلال يعطي الأولوية للخصوصية، ونماذج بدون رقابة، وتسعير تنافسي.

## الانتقال في سطرين

<CodeGroup>
  ```python Python theme={"system"}
  # قبل (OpenAI)
  from openai import OpenAI
  client = OpenAI()

  # بعد (Venice) — غيّر api_key و base_url
  from openai import OpenAI
  client = OpenAI(
      api_key="your-venice-api-key",           # ← التغيير 1
      base_url="https://api.venice.ai/api/v1",  # ← التغيير 2
  )
  ```

  ```javascript Node.js theme={"system"}
  // قبل (OpenAI)
  import OpenAI from "openai";
  const client = new OpenAI();

  // بعد (Venice)
  import OpenAI from "openai";
  const client = new OpenAI({
    apiKey: "your-venice-api-key",
    baseURL: "https://api.venice.ai/api/v1",
  });
  ```

  ```bash cURL theme={"system"}
  # قبل
  curl https://api.openai.com/v1/chat/completions ...

  # بعد — فقط غيّر عنوان URL والمفتاح
  curl https://api.venice.ai/api/v1/chat/completions ...
  ```
</CodeGroup>

أنشئ مفتاحاً من [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation) أو اتّبع [دليل مفتاح API](/guides/getting-started/generating-api-key).

### متغيرات البيئة

```bash theme={"system"}
# قبل
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1

# بعد
OPENAI_API_KEY=your-venice-api-key
OPENAI_BASE_URL=https://api.venice.ai/api/v1
```

<Tip>
  تقرأ كثير من المكتبات والأدوات المتغيرين `OPENAI_API_KEY` و`OPENAI_BASE_URL` تلقائياً. قد يكفي تحديث متغيرات البيئة هذه فقط. لا تزال بعض الأدوات تستخدم `OPENAI_API_BASE` للإشارة إلى نفس عنوان URL.
</Tip>

## النماذج

مرّر معرّف نموذج Venice، أو سمة (trait) مثل `default` أو `most_uncensored`، أو اسماً مألوفاً بأسلوب OpenAI. تقوم Venice بربط أسماء OpenAI عبر [ربط التوافق](/api-reference/endpoint/models/compatibility_mapping). أما السمات فتُحلّ دائماً إلى النموذج الحالي الذي يؤدي هذا الدور — انظر [سمات النماذج](/api-reference/endpoint/models/traits).

تصفّح الكتالوج الحيّ في [نماذج النصوص](/models/text) و[التسعير](/overview/pricing). لجولة إرشادية عبر أول طلب، راجع [البدء السريع](/getting-started/quick-start).

## توافق الميزات

| الميزة                                | OpenAI | Venice | ملاحظات                                                                                                      |
| ------------------------------------- | ------ | ------ | ------------------------------------------------------------------------------------------------------------ |
| Chat Completions                      | ✅      | ✅      | متوافقة بالكامل                                                                                              |
| البثّ (Streaming)                     | ✅      | ✅      | نفس تنسيق SSE                                                                                                |
| استدعاء الدوال (Function Calling)     | ✅      | ✅      | نفس المعامل `tools`                                                                                          |
| المخرجات المنظّمة (Structured Output) | ✅      | ✅      | نفس `response_format`                                                                                        |
| الرؤية (Vision)                       | ✅      | ✅      | نفس تنسيق مصفوفة المحتوى                                                                                     |
| Embeddings                            | ✅      | ✅      | النص فقط؛ مصفوفات الـ tokens تُعيد HTTP 400                                                                  |
| توليد الصور                           | ✅      | ✅      | متوافق مع OpenAI عبر `/images/generations`                                                                   |
| تحرير الصور                           | ✅      | ❌      | لا توجد نقطة نهاية `/images/edits`؛ استخدم نقطة النهاية الأصلية [`/image/edit`](/guides/media/image-editing) |
| TTS                                   | ✅      | ✅      | متوافق                                                                                                       |
| STT                                   | ✅      | ✅      | متوافق                                                                                                       |
| Responses API                         | ✅      | ✅      | Alpha                                                                                                        |
| Assistants API                        | ✅      | ❌      | استخدم [الشخصيات](/guides/features/characters) أو [استدعاء الدوال](/guides/features/function-calling)        |
| Batch API                             | ✅      | ❌      | غير متاح بعد                                                                                                 |
| الضبط الدقيق (Fine-tuning)            | ✅      | ❌      | غير متاح                                                                                                     |

للاطلاع على خيارات الصور الأصلية التي تتجاوز نقطة النهاية المتوافقة مع OpenAI، انظر [توليد الصور](/guides/media/image-generation).

## ميزات حصرية لـ Venice

مرّر الخيارات الخاصة بـ Venice عبر `extra_body` بوصفها `venice_parameters`. البحث المدمج على الويب هو عادةً أول إضافة تحتاجها:

```python theme={"system"}
response = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Latest AI news today"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    },
)
```

يغطي النمط نفسه الزحف على الويب (web scraping) والاقتباسات و[الشخصيات](/guides/features/characters). إذا كان العميل لا يستطيع تغيير جسم الطلب، أضف [لاحقة ميزة النموذج](/api-reference/endpoint/chat/model_feature_suffix) مثل `default:enable_web_search=auto`.

كما تمتلك Venice واجهات API أصلية لـ[الفيديو](/guides/media/video-generation) و[الموسيقى](/guides/media/music-and-sound-effects) و[استرجاع الويب](/guides/tools/web-retrieval) و[x402](/guides/integrations/x402-venice-api) إلى جانب الواجهة المتوافقة مع OpenAI.

## الأُطر (Frameworks)

تعمل معظم أُطر الذكاء الاصطناعي مع Venice بمجرد تغيير base URL:

<CardGroup cols={3}>
  <Card title="LangChain" icon="link" href="/guides/integrations/langchain">
    `base_url` في `ChatOpenAI`؛ `check_embedding_ctx_length=False` على `OpenAIEmbeddings`
  </Card>

  <Card title="Vercel AI SDK" icon="link" href="/guides/integrations/vercel-ai-sdk">
    `baseURL` في `createOpenAI`
  </Card>

  <Card title="LlamaIndex" icon="link" href="/guides/integrations/llamaindex">
    `api_base` في العميل المتوافق مع OpenAI
  </Card>

  <Card title="CrewAI" icon="link" href="/guides/integrations/crewai">
    متغير البيئة `OPENAI_API_BASE`
  </Card>

  <Card title="PydanticAI" icon="link" href="/guides/integrations/pydanticai">
    نموذج متوافق مع OpenAI باستخدام base URL الخاص بـ Venice
  </Card>

  <Card title="Cursor" icon="link" href="/guides/integrations/cursor">
    نقطة نهاية API مخصّصة في الإعدادات
  </Card>

  <Card title="Claude Code" icon="link" href="/guides/integrations/claude-code">
    توجيه Claude Code عبر Venice
  </Card>

  <Card title="Codex CLI" icon="link" href="/guides/integrations/codex-cli">
    مزوّد النموذج في `config.toml`
  </Card>

  <Card title="Aider" icon="link" href="/guides/integrations/aider">
    متغير البيئة `OPENAI_API_BASE`
  </Card>
</CardGroup>

يمكنك الاطلاع على مزيد من وكلاء البرمجة والأدوات في [وكلاء الذكاء الاصطناعي](/guides/integrations/ai-agents).

## النماذج بدون رقابة

نماذج Venice الخاصة بدون رقابة لا تطبّق أي تصفية للمحتوى، مما يجعلها مناسبة لـ:

* الكتابة الإبداعية بدون قيود
* أبحاث الأمن والاختبار الهجومي (red teaming)
* التحليل الصادق بدون أنماط الرفض
* المعلومات الطبية والقانونية بدون إخلاءات مسؤولية إضافية

استخدم السمة `most_uncensored` أو معرّف نموذج حالي بدون رقابة من [نماذج النصوص](/models/text).

<Card title="احصل على مفتاح API الخاص بك" icon="key" href="https://venice.ai/settings/api?utm_source=venice-api-documentation">
  أنشئ مفتاح Venice API وابدأ الانتقال في دقائق
</Card>