حِزَم التطوير (SDKs)

يُقدّم حكيم حزمتي تطوير رسميتين، وكلتاهما تتحدّثان مباشرةً مع نفس واجهة REST/WebSocket العامة الموثّقة في المرجع.

TypeScript / JavaScript

npm install @tryhakim/voice

import { Hakim } from '@tryhakim/voice';

const hakim = new Hakim({ apiKey: process.env.HAKIM_API_KEY! });

const speech = await hakim.audio.speech.create({
  model: 'hakim-fast-v1',
  input: 'مرحبا، أنا حكيم.',
  voice: 'your-voice-id',
  response_format: 'mp3',
});

البث المباشر (بدء أسرع بزمن استجابة أقل):

const { stream } = await hakim.audio.speech.stream({
  model: 'hakim-fast-v1',
  input: 'مرحبا',
  voice: 'your-voice-id',
});
for await (const chunk of stream) {
  process.stdout.write(chunk);
}

الشيفرة المصدرية وكامل سطح الواجهة: github.com/tryHakimAI/hakim-node.

Python

pip install hakim

from hakim import Hakim

client = Hakim(api_key=os.environ["HAKIM_API_KEY"])
audio = client.audio.speech.create(
    model="hakim-fast-v1",
    input="مرحبا، أنا حكيم.",
    voice="your-voice-id",
)

تُقدّم الحزمة عميلًا متزامنًا (Hakim) وآخر غير متزامن (AsyncHakim). الشيفرة المصدرية وكامل سطح الواجهة: github.com/tryHakimAI/hakim-python.

تكاملات وكلاء الصوت

هل تبني وكيل صوت (voice agent) بدلًا من استدعاء الواجهة مباشرة؟ تتوفّر إضافات جاهزة لإطارين مفتوحَي المصدر شائعَين:

كلتا الإضافتين تتحدّثان مباشرةً مع واجهة Hakim العامة REST/WebSocket، لذا تعملان أينما يعمل الإطار الأساسي.

كلتا الحزمتين تحترمان ترويسة Authorization: Bearer وتعيدان المحاولة عند الحصول على 429 بحسب قيمة Retry-After في الردّ.