أول طلب في Rust باستخدام async-openai: عنوان URL الأساسي، المفتاح، الاستخدام

لاستدعاء CheapTokens من Rust باستخدام async-openai، أنشئ OpenAIConfig بعنوان URL الأساسي https://api.cheaptokens.dev/v1 ومفتاحك، ثم أرسل الطلب باستخدام create_byot وجسم JSON. يخرج نص الرد وأعداد الرموز من JSON الذي يعود. هذا نحو 25 سطرًا من الشيفرة، ويعمل البرنامج نفسه مع أي نموذج على صفحة نماذج CheapTokens بمجرد تغيير سلسلة واحدة.

تسرد صفحة docs.rs الخاصة بالحزمة (تم التحقق منها في 8 نوفمبر 2026) الإصدار 0.43.0 تحت رخصة MIT، وهذا هو الإصدار الذي يتبعه هذا الدليل.

لماذا create_byot بدلًا من الطلبات المكتوبة الأنواع#

عادةً ما يمنحك async-openai مُنشئ طلبات مكتوب الأنواع: تملأ بنية، فيعيد لك بنية. هذا مريح حتى يعيد البوابة حقلًا لا تعرفه البنيات. تضيف ميزة byot ("أحضر أنواعك الخاصة") دوال *_byot التي تقبل أي جسم JSON وتعيد أي نوع يمكنك إلغاء تسلسله إليه، بما في ذلك serde_json::Value العادي.

بالنسبة لأول طلب، هذا بالضبط ما تريده. تكتب نفس JSON التي كنت ستضعها في استدعاء curl، وتقرأ usage مباشرة من الاستجابة، دون نوع تبحث عنه.

إعداد المشروع#

cargo add async-openai --features byot,chat-completion
cargo add tokio --features macros,rt-multi-thread
cargo add serde_json

export CHEAPTOKENS_API_KEY="paste-your-key-here"

cargo run

البرنامج#

use async_openai::{config::OpenAIConfig, Client};
use serde_json::{json, Value};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let key = std::env::var("CHEAPTOKENS_API_KEY")?;

    let config = OpenAIConfig::new()
        .with_api_key(key)
        .with_api_base("https://api.cheaptokens.dev/v1");
    let client = Client::with_config(config);

    let response: Value = client
        .chat()
        .create_byot(json!({
            "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
            "messages": [
                {"role": "user", "content": "Explain what a token is in one sentence."}
            ],
            "max_tokens": 100
        }))
        .await?;

    let choice = &response["choices"][0];
    println!("{}", choice["message"]["content"].as_str().unwrap_or("(no text)"));
    println!("finish_reason: {}", choice["finish_reason"]);
    println!("input tokens:  {}", response["usage"]["prompt_tokens"]);
    println!("output tokens: {}", response["usage"]["completion_tokens"]);
    Ok(())
}

ثلاثة أسطر تحمل الفكرة كلها. with_api_base هو حيث يدخل CheapTokens: ينتهي عنوان URL الأساسي بـ /v1، ويضيف async-openai مسار نقطة النهاية بنفسه. with_api_key يأخذ القيمة التي قرأناها من متغير البيئة. وmodel هو المعرّف الكامل deepseek-ai/DeepSeek-V4-Flash-0731 — الأسماء القصيرة من جداول الأسعار لا يقبلها API.

فهرسة Value بمفتاح مفقود تعطي null بدلًا من panic، لذا يظهر خطأ مطبعي في اسم حقل كـ null في المخرجات بدلًا من انهيار. هذا مفيد عند استكشاف استجابة.

ما يعود#

تتحدث البوابة صيغة OpenAI Chat Completions، لذا يكون للاستجابة الشكل المعتاد (مقتطعة هنا، علامات ... تشير إلى حقول نتخطاها):

{
  "choices": [
    { "message": { "role": "assistant", "content": "..." }, "finish_reason": "stop" }
  ],
  "usage": { "prompt_tokens": 0, "completion_tokens": 0 }
}

الأرقام في usage هي أعداد حقيقية لطلبك، لذا تحل محل الأصفار عند تشغيله. prompt_tokens هو ما أرسلته، وcompletion_tokens هو ما كتبه النموذج. يُفوتران بأسعار مختلفة، وهذا هو الهدف من طباعتهما. إذا كانت الفروق جديدة عليك، فإن رموز الإدخال مقابل الإخراج تشرحها في خمس دقائق.

تكلفة طلب واحد#

لنفترض أنك تشغّل هذا الاستدعاء في حلقة، سؤال صغير داخل وإجابة قصيرة خارج: 300 رمز إدخال و200 رمز إخراج في كل مرة. على DeepSeek-V4-Flash هذا $0.000025 لكل طلب، من السعر الحالي $0.015 لكل 1M رمز إدخال و$0.10 لكل 1M رمز إخراج. محسوبين معًا، الإدخال والإخراج، هذا أرخص من OpenRouter، ويحتفظ النموذج بسياق 380K ويجيب حتى 32,768 رمزًا.

يوضح الجدول أدناه الطلب نفسه على كل نموذج، مضروبًا في 1,000.

الأسعار موجودة على صفحة التسعير.

تبديل النموذج#

لا تتغير الشيفرة عندما يتغير النموذج؛ فقط السلسلة في "model" تتغير. على سبيل المثال، zai-org/GLM-5.3-Flash لديه سياق 390K ويجيب حتى 8,192 رمزًا. لتجنب تعديل الشيفرة تمامًا، اقرأ المعرّف من متغير ثانٍ باستخدام std::env::var("CHEAPTOKENS_MODEL"). إذا لم تكن متأكدًا من المعرّفات التي يراها مفتاحك، فـاسرد النماذج باستخدام GET /v1/models.

إذا لم يعمل#

• environment variable not found في البداية تمامًا: المفتاح غير مُصدَّر في هذا الطرفية. صدّره مرة أخرى في النافذة نفسها التي تشغّل فيها cargo run.
• خطأ 401 من API: المفتاح خاطئ أو حوله مسافة أو علامة اقتباس شاذة.
• خطأ 404: تحقق من أن عنوان URL الأساسي ينتهي بـ /v1 وأن معرّف النموذج هو الكامل، مع بادئة deepseek-ai/. API 401 أو 404: المفتاح، عنوان URL الأساسي، معرّف النموذج يشرح ذلك خطوة بخطوة.
• لا يجد المترجم create_byot: ميزة byot غير مفعّلة. شغّل سطر cargo add من الإعداد مرة أخرى.

لمشكلة اتصال ليست أيًا من هذه، راجع أخطاء الاتصال الشائعة.

الطلب الأول نفسه موجود للغات أخرى: Go وRuby. لمزيد عن API نفسه، افتح وثائق CheapTokens.