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

# الشخصيات

> اكتشف شخصيات Venice العامة، وابحث عن معرّفاتها (slugs)، وتحدّث مع شخصياتها عبر واجهة chat completions من Venice المتوافقة مع OpenAI.

الشخصيات هي شخصيّات عامة يمكنك تطبيقها على إكمال محادثة. لكل شخصية `slug` ونموذج نصي مرتبط بها.

<Warning>
  واجهة Characters API في مرحلة المعاينة وقد تتغيّر.
</Warning>

## اكتشاف شخصية

استخدم [نقطة نهاية List Characters](/api-reference/endpoint/characters/list) للبحث في الكتالوج العام وتصفيته:

```bash cURL theme={null}
curl "https://api.venice.ai/api/v1/characters?search=philosophy&limit=5" \
  -H "Authorization: Bearer $VENICE_API_KEY"
```

تحتوي الاستجابة على القيم اللازمة لإكمالات المحادثة:

```json theme={null}
{
  "data": [
    {
      "name": "Alan Watts",
      "slug": "alan-watts",
      "modelId": "venice-uncensored-1-2",
      "description": "A philosophical entertainer...",
      "webEnabled": true
    }
  ],
  "object": "list"
}
```

يمكنك أيضًا جلب شخصية واحدة عبر الـ slug باستخدام [نقطة نهاية Get Character](/api-reference/endpoint/characters/get):

```bash cURL theme={null}
curl "https://api.venice.ai/api/v1/characters/alan-watts" \
  -H "Authorization: Bearer $VENICE_API_KEY"
```

استخدم قيمة `slug` المُعادة على أنّها `venice_parameters.character_slug`. واستخدم قيمة `modelId` الخاصة بها بوصفها نموذج إكمال المحادثة، أو اختر نموذجًا متوافقًا من [صفحة النماذج النصية](/models/text).

## التحدّث مع الشخصية

مرّر `character_slug` ضمن `venice_parameters` عند استدعاء واجهة Chat Completions المتوافقة مع OpenAI:

<CodeGroup>
  ```python Python theme={null}
  import os
  import requests
  from openai import OpenAI

  headers = {"Authorization": f"Bearer {os.environ['VENICE_API_KEY']}"}
  character = requests.get(
      "https://api.venice.ai/api/v1/characters/alan-watts",
      headers=headers,
      timeout=30,
  ).json()["data"]

  client = OpenAI(
      api_key=os.environ["VENICE_API_KEY"],
      base_url="https://api.venice.ai/api/v1",
  )

  response = client.chat.completions.create(
      model=character["modelId"],
      messages=[
          {"role": "user", "content": "How can I worry less about the future?"}
      ],
      extra_body={
          "venice_parameters": {
              "character_slug": character["slug"],
          }
      },
  )

  print(response.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from "openai";

  const characterResponse = await fetch(
    "https://api.venice.ai/api/v1/characters/alan-watts",
    {
      headers: {
        Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
      },
    },
  );
  const { data: character } = await characterResponse.json();

  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: character.modelId,
    messages: [
      { role: "user", content: "How can I worry less about the future?" },
    ],
    venice_parameters: {
      character_slug: character.slug,
    },
  });

  console.log(response.choices[0].message.content);
  ```

  ```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": "venice-uncensored",
      "messages": [
        {
          "role": "user",
          "content": "How can I worry less about the future?"
        }
      ],
      "venice_parameters": {
        "character_slug": "alan-watts"
      }
    }'
  ```
</CodeGroup>

<Note>
  تنطبق قيم slug للشخصيات على شخصيات Venice العامة فقط. يؤدي تمرير slug مفقود أو غير صالح إلى إرجاع خطأ من واجهة برمجة التطبيقات.
</Note>

## موارد ذات صلة

* [النماذج النصية](/models/text)
* [واجهة List Characters API](/api-reference/endpoint/characters/list)
* [واجهة Get Character API](/api-reference/endpoint/characters/get)
* [واجهة Character Reviews API](/api-reference/endpoint/characters/reviews)
* [واجهة Chat Completions API](/api-reference/endpoint/chat/completions)