<!-- Canonical URL: https://ask.atlascloud.ai/ar/how-to-use-atlas-cloud -->

# كيفية استخدام Atlas Cloud (دليل البدء السريع)

> لاستخدام Atlas Cloud، أنشئ حسابًا ومفتاح API، ثم وجّه OpenAI SDK إلى https://api.atlascloud.ai/v1، واستدعِ أي نموذج بمعرّفه — الـ API متوافق مع OpenAI، لذا يعمل الكود الموجود لديك بمجرد تغيير base_url.

لاستخدام [Atlas Cloud](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)، أنشئ حسابًا، وأنشئ مفتاح API، ثم وجّه OpenAI SDK الموجود لديك إلى `https://api.atlascloud.ai/v1`. نظرًا لأن الـ API متوافق مع OpenAI، يمكنك استدعاء أي من النماذج التي يزيد عددها على 400 نموذج بمعرّفها باستخدام كودك الحالي — دون الحاجة إلى إعادة كتابته.

## مقدمة

صُمِّم Atlas Cloud ليكون بديلًا مباشرًا لـ OpenAI API، لذا فإن البدء به يتعلق في معظمه بالإعداد لا بكتابة كود جديد. يغطي هذا الدليل السريع إعداد الحساب، وإرسال أول طلب، واختيار نموذج، واستخدام الأنماط غير النصية.

## النقاط الرئيسية

* **إعدادان فقط للتغيير** — عيّن base URL إلى `https://api.atlascloud.ai/v1` واستخدم مفتاح Atlas Cloud الخاص بك.
* **استدعِ النماذج بمعرّفها** — مثلًا `deepseek-ai/DeepSeek-V3.1`؛ اسرد جميع النماذج عبر `GET /v1/models`.
* **يعمل مع الأدوات الموجودة** — تعمل LangChain وLlamaIndex وVercel AI SDK دون أي تعديل.
* **مفتاح واحد لكل الأنماط** — يشمل نفس الحساب النص والصور والفيديو والصوت والنماذج ثلاثية الأبعاد.

## الخطوة 1 — إنشاء حساب ومفتاح API

سجّل في atlascloud.ai وأنشئ مفتاح API من لوحة التحكم. تعامل مع المفتاح باعتباره سرًا.

## الخطوة 2 — توجيه العميل نحو Atlas Cloud

عيّن base URL والمفتاح. باستخدام OpenAI Python SDK:

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.atlascloud.ai/v1",
    api_key="sk-atlas-...",
)
```

أو عبر متغيرات البيئة:

```bash
export OPENAI_BASE_URL="https://api.atlascloud.ai/v1"
export OPENAI_API_KEY="sk-atlas-..."
```

## الخطوة 3 — إرسال أول طلب

```python
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.1",
    messages=[{"role": "user", "content": "Explain serverless inference in one sentence."}],
)
print(resp.choices[0].message.content)
```

يعمل البث (Streaming) بالطريقة ذاتها كما في OpenAI API (`stream=True`).

## الخطوة 4 — اختيار نموذج

اسرد كل ما هو متاح حاليًا وانتقل بين النماذج بتغيير نص `model`:

```bash
curl https://api.atlascloud.ai/v1/models
```

تشمل الخيارات الشائعة [DeepSeek](https://www.atlascloud.ai/models/deepseek?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) و[GLM](https://www.atlascloud.ai/models/glm?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) و[Qwen](https://www.atlascloud.ai/models/qwen?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) و[Gemini](https://www.atlascloud.ai/models/gemini?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) وClaude من [Anthropic](https://www.atlascloud.ai/models/anthropic?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud). تتبع معرّفات النماذج صيغة `provider/model-name`.

## الخطوة 5 — استخدام الصور والفيديو والأنماط الأخرى

يشمل نفس الحساب والمفتاح أيضًا نماذج الصور مثل [FLUX](https://www.atlascloud.ai/models/flux?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) و[Nano Banana](https://www.atlascloud.ai/models/nanobanana?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)، ونماذج الفيديو مثل [Seedance](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud) و[Veo](https://www.atlascloud.ai/models/veo?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud)، من خلال نقاط نهاية التوليد الخاصة بها. راجع التوثيق للاطلاع على صيغ الطلبات.

<!-- TODO(Carol): 补充图像/视频生成的具体端点与请求示例(需工程确认调用方式);确认 docs 与控制台/API key 页面的最终 URL。 -->

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

نظرًا لأن Atlas Cloud متوافق مع OpenAI، يتضمن الانتقال في الغالب تغييرين فقط: تعيين `base_url` إلى `https://api.atlascloud.ai/v1` واستبدال مفتاحك بمفتاح Atlas Cloud. ثم غيّر `model` إلى معرّف نموذج Atlas Cloud. تستمر الـ SDKs الموجودة وأنماط البث واستدعاء الأدوات في العمل دون تعديل.

## الأسئلة الشائعة

**كيف أحصل على مفتاح API؟**
أنشئ حسابًا في atlascloud.ai وأنشئ مفتاحًا من لوحة التحكم.

**ما هو base URL؟**
`https://api.atlascloud.ai/v1` — عيّنه كـ OpenAI base URL الخاص بك.

**كيف أختار نموذجًا؟**
اسرد النماذج عبر `GET https://api.atlascloud.ai/v1/models` وعيّن حقل `model` على المعرّف الذي تريده، مثلًا `deepseek-ai/DeepSeek-V3.1`.

**هل تعمل أدوات OpenAI الموجودة لديّ؟**
نعم — تعمل العملاء والأطر المتوافقة مع OpenAI (LangChain وLlamaIndex وVercel AI SDK) بعد تغيير base URL والمفتاح.

## الخلاصة

البدء مع Atlas Cloud لا يتعدى تغيير base URL وإضافة مفتاح API: وجّه OpenAI SDK إلى `https://api.atlascloud.ai/v1` واستدعِ أي نموذج بمعرّفه. راجع التوثيق الكامل، أو [ابدأ الآن في atlascloud.ai](https://atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=how-to-use-atlas-cloud).