قیمت کلاود: شروع سریع و مرجع API

نصب و راه‌اندازی محیط

ابتدا کتابخانه کلاینت رسمی را برای زبان خود نصب کنید. سرویس ما پشت استاندارد /v1 مسیر را تغییر دهید، بنابراین فقط باید URL پایه و کلید API را به‌روزرسانی کنید. URL پایه در این سایت HTTPS://api.claudeprecio.com/v1 است. احراز هویت بر اساس یک کلید فعال واحد برای هر حساب است. می‌توانید این کلید را فوراً از طریق گوگل یا ایمیل در صفحه "دریافت کلید API" ایجاد کنید. شماره تلفن لازم نیست. کلید یک بار نمایش داده می‌شود، بنابراین آن را به امنیت کپی کنید.

انجام اولین درخواست با Python

یک درخواست تکمیل را با استفاده از SDK استاندارد پایتون ارسال کنید. کلاینت را به URL پایه ما پوینت دهید و مدل را روی "uncensored" تنظیم کنید. این مدل وزن‌باز روی سرورهای خود ما اجرا می‌شود و برای پاسخ دادن بدون رد محتوا تنظیم شده است. می‌توانید پارامترهایی مانند temperature یا top_p همانطور که با هر سروس سازگار با OpenAI انجام می‌دهید. ساختار درخواست دقیقاً مشابه فرمت استاندارد است.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudeprecio.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

بررسی کنید که پاسخ شامل متن تولید شده است. اگر خطای 401 دریافت کردید، کلید شما نامعتبر است. خطای 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. خطاها در حین تولید توکن مصرف نمی‌کنند، بنابراین شما فقط برای خروجی موفق پرداخت می‌کنید.

پاسخ‌های استریم‌شده و ردیابی استفاده

استریمینگ را با تنظیم stream=True در پیکربندی کلاینت خود. API برای هر توکن تولید شده، رویدادهای ارسال‌شده توسط سرور (SSE) را برمی‌گرداند. این امکان را به شما می‌دهد تا متن را به صورت بلادرنگ در حالی که منتظر پاسخ کامل هستید، نمایش دهید. داده‌های مصرف، از جمله تعداد توکن‌های ورودی و خروجی، در قطعه نهایی جریان داده گنجانده شده است. این رویکرد، تأخیر ادراک‌شده برای خروجی‌های طولانی را کاهش می‌دهد. این روش به‌طور کامل با SDKهای استاندارد کار می‌کند.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

قطع شدن استریم را به صورت ایمن مدیریت کنید. افت‌های شبکه ممکن است باعث باقی ماندن پاسخ‌های ناقص شود. همیشه قطعه نهایی را برای آمار دقیق مصرف توکن بررسی کنید. این کار باعث می‌شود داشبورد صورت‌حساب شما با مصرف واقعی مطابقت داشته باشد.

پارامترها: temperature، top_p و seed

خلاقیت و قابلیت بازتولید را با پارامترهای تولید استاندارد کنترل کنید. مدل temperature مقدار تصادفی بودن را تنظیم می‌کند، مقادیر پایین‌تر خروجی‌های قطعی‌تری تولید می‌کنند. از top_p برای محدود کردن نمونه‌برداری به بیشترین جرم احتمال. تنظیم seed برای ثابت کردن حالت تصادفی برای نتایج قابل تکرار در فراخوانی‌های متعدد. این پارامترها دقیقاً مانند استاندارد OpenAI کار می‌کنند. آن‌ها را بر اساس مورد استفاده خود، چه کدنویسی و چه نوشتن خلاقانه، تنظیم کنید.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.claudeprecio.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

این تنظیمات را برای کنترل دقیق ترکیب کنید. برای مثال، دمای پایین همراه با seed ثابت خروجی‌های یکسانی برای آزمایش تضمین می‌کند. مدل از تمام پارامترهای استاندارد مانند stop sequences و presence_penalty. برای یافتن تعادل مناسب برای پروژه خاص خود آزمایش کنید.

فراخوانی تابع و حالت JSON

از فراخوانی تابع برای یکپارچه‌سازی API در برنامه‌های خود استفاده کنید. ابزارها را در بدنه درخواست تعریف کنید و مدل JSON ساختاریافته شامل آرگومان‌های تابع را برمی‌گرداند. حالت JSON را با تنظیم response_format به {"type": "json_object"}. این امر تضمین می‌کند که خروجی همیشه JSON معتبر باشد که تجزیه را ساده می‌کند. این کار را برای استخراج داده‌ها یا پاسخ‌های ساختاریافته انجام دهید. مدل تعاریف ابزار پیچیده را به‌طور کارآمد مدیریت می‌کند.

Copycurl https://api.claudeprecio.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total cost for 10 million input tokens and 3 million output tokens"}]
  }'

تست فراخوانی تابع با یک تعریف ابزار ساده. بررسی کنید که آیا مدل به طرحواره ابزار پایبند است. حالت JSON زمانی بسیار مفید است که به ساختارهای خروجی قابل پیش‌بینی نیاز دارید. آن را با جریان‌دهی (streaming) ترکیب کنید تا پردازش داده‌ها به صورت بلادرنگ انجام شود. این ویژگی، API را برای کاربردهای سطح تولید مناسب می‌سازد.

Limits, errors, and context window

پنجره زمینه (context window) از ۱۰۰,۰۰۰ توکن برای ورودی (prompt) و خروجی (completion) ترکیبی پشتیبانی می‌کند. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است. اگر max_tokens تنظیم نشده است، محدودیت پیش‌فرض 2,048 است. شما مجاز به 300 درخواست در دقیقه در هر کلید هستید. همزمانی به 8 درخواست همزمان در هر کلید محدود است. بدنه درخواست نباید از 8 مگابایت تجاوز کند. خطاهایی مانند 401، 402 و 429 از طریق کدهای وضعیت HTTP استاندارد مدیریت می‌شوند. مصرف توکن به‌دقت صورت می‌گیرد و خطاها رایگان هستند.