> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# الشخصيات

> اكتشف شخصيات Venice العامة واستخدم شخصياتها مع النماذج النصية عبر واجهة chat completions المتوافقة مع OpenAI.

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

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

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

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

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

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

```json theme={"system"}
{
  "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={"system"}
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={"system"}
  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={"system"}
  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={"system"}
  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)