Developer guide

API কী ব্যৱহাৰ কৰি প্ৰমাণীকৰণ কৰা

API কী ৰখা হেডাৰ আৰু SDK-ত ছেট কৰিবলগীয়া base URL

এই পৃষ্ঠাত CLEVI গেটৱেত API কী ব্যৱহাৰ কৰি কেনেকৈ প্ৰমাণীকৰণ কৰিব লাগে সেই বিষয়ে আলোচনা কৰা হৈছে।
OpenAI-সামঞ্জস্যপূৰ্ণ পথ আৰু Anthropic-সামঞ্জস্যপূৰ্ণ পথ দুয়োটাতে এটা কী ব্যৱহাৰ কৰি প্ৰমাণীকৰণ কৰা হয়,
কিন্তু কী ৰখা হেডাৰৰ অনুমোদিত পৰিসৰ আৰু SDK-ত ছেট কৰিবলগীয়া base URL প্ৰতিটো স্পেচিফিকেশ্যন অনুসৰি পৃথক।

প্ৰমাণীকৰণ হেডাৰ

দুয়োটা সামঞ্জস্যপূৰ্ণ স্পেচিফিকেশ্যনতে এটা API কী ব্যৱহাৰ কৰি প্ৰমাণীকৰণ কৰা হয়। কী কনছ’লৰ API কী পৃষ্ঠাৰ পৰা জাৰি কৰা হয়, আৰু একেটা পৃষ্ঠাৰ পৰাই বাতিল কৰা আৰু ব্যৱহাৰৰ পৰিসৰ পৰিচালনা কৰা হয়।

হেডাৰOpenAI-সামঞ্জস্যপূৰ্ণAnthropic-সামঞ্জস্যপূৰ্ণ
X-API-Key: <কী>ব্যৱহাৰ কৰিব পাৰিব্যৱহাৰ কৰিব পাৰি
Authorization: Bearer <কী>ব্যৱহাৰ কৰিব পাৰিব্যৱহাৰ কৰিব পাৰি
Authorization: <কী> (Bearer অবিহনে)প্ৰত্যাখ্যান কৰা হয়ব্যৱহাৰ কৰিব পাৰি

হেডাৰৰ নামত ডাঙৰ-সৰু আখৰৰ পাৰ্থক্য কৰা নহয়। Anthropic SDK-য়ে পঠোৱা x-api-key-ও একেদৰেই কাম কৰে।

base URL

আপুনি ব্যৱহাৰ কৰি থকা SDK-ত base URL-টো তলৰ ঠিকনালৈ সলনি কৰিলেই একেদৰেই ব্যৱহাৰ কৰিব পাৰিব। দুয়োটা ঠিকনাৰ মাজত /v1 অন্তৰ্ভুক্ত হয় নে নহয়, সেই পাৰ্থক্য আছে।

স্পেচিফিকেশ্যনbase URLপথৰ নিয়ম
OpenAI-সামঞ্জস্যপূৰ্ণhttps://platform.clevi.net/api/v2/aiservice/openai/v1/v1 লৈকে base URL-ত অন্তৰ্ভুক্ত কৰক।
Anthropic-সামঞ্জস্যপূৰ্ণhttps://platform.clevi.net/api/v2/aiservice/anthropicAnthropic SDK-য়ে পথত নিজেই /v1 যোগ কৰে, সেয়ে /v1-ৰ আগতেই শেষ হয়।

প্ৰমাণীকৰণ পৰীক্ষা

কী আৰু base URL সংযুক্ত কৰি মডেলৰ তালিকা চালে প্ৰমাণীকৰণ হৈছে নে নাই সেয়া তৎক্ষণাৎ জানিব পাৰি। তলৰ তিনিটা উদাহৰণত একেটা查询 curl, OpenAI SDK আৰু Anthropic SDK-ৰ জৰিয়তে কৰা হৈছে।

curl https://platform.clevi.net/api/v2/aiservice/openai/v1/models \
  -H "X-API-Key: sk-..."

curl https://platform.clevi.net/api/v2/aiservice/anthropic/v1/models \
  -H "Authorization: Bearer sk-..." \
  -H "anthropic-version: 2023-06-01"
from openai import OpenAI

client = OpenAI(
    api_key="sk-...",
    base_url="https://platform.clevi.net/api/v2/aiservice/openai/v1",
)

for model in client.models.list():
    print(model.id)
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-...",
    base_url="https://platform.clevi.net/api/v2/aiservice/anthropic",
)

for model in client.models.list(limit=20).data:
    print(model.id)

sk-...-ৰ ঠাইত API কী পৃষ্ঠাৰ পৰা জাৰি কৰা কীটো দিয়ক।

  • উত্তৰ 200 হ’লে প্ৰমাণীকৰণ সম্পন্ন হৈছে। data-ত এই কী ব্যৱহাৰ কৰি কল কৰিব পৰা মডেলসমূহৰ তালিকা থাকে।
  • উত্তৰ 401 হ’লে তলৰ প্ৰমাণীকৰণ বিফলতা অংশত দিয়া ক্ৰম অনুসৰি পৰীক্ষা কৰক।

একেলগে ব্যৱহাৰ কৰা হেডাৰ

এই সকলোবোৰ ঐচ্ছিক। সমস্যাটো অনুসৰণ কৰিবলৈ X-Request-Id যোগ কৰি ৰখাটো ভাল।

হেডাৰব্যৱহাৰবাদ দিলে
X-Request-Idঅনুৰোধ অনুসৰণৰ বাবে চিনাক্তকৰ্তা। Anthropic-সামঞ্জস্যপূৰ্ণ সঁহাৰিত request-id হেডাৰ হিচাপে ঘূৰাই পঠিওৱা হয়।ছাৰ্ভাৰে জাৰি কৰে।
X-Region-Codeকলৰ অঞ্চলglobal হয়।
X-Product-Sku (কুৱেৰী product_sku হিচাপেও ব্যৱহাৰ কৰিব পাৰি)বিলিঙৰ বাবে ব্যৱহাৰ কৰিবলগীয়া Product SKU পোনপটীয়াকৈ নিৰ্ধাৰণ কৰে। হেডাৰে কুৱেৰীতকৈ অগ্ৰাধিকাৰ পায় আৰু মূলতঃ ভইচ পথত ব্যৱহাৰ কৰা হয়।ভইচ পথত প্ৰয়োজন হয়। audio/speech আৰু audio/transcriptions-এ অনুৰোধৰ body-ৰ model-ৰ জৰিয়তে Product নিৰ্বাচন কৰে।
anthropic-version / anthropic-betaAnthropic-সামঞ্জস্যপূৰ্ণ পথত একেদৰেই আগবঢ়াই পঠিওৱা হয়।ভাৰ্চনটো 2023-06-01।

প্ৰমাণীকৰণ বিফল

কী নথকা বা ম্যাদ উকলি যোৱা·বাতিল কৰা কী পঠিয়ালে 401 হয়। OpenAI-সামঞ্জস্যপূৰ্ণ পথত কী অবিহনে কল কৰিলে তলৰ body পোৱা যায়, আৰু Anthropic-সামঞ্জস্যপূৰ্ণ পথৰ error.type হৈছে authentication_error।

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}
  1. API কী স্ক্ৰীণত কীটোৰ অৱস্থা পৰীক্ষা কৰক। ম্যাদ উকলি যোৱা·বাতিল কৰা কী হ’লে নতুন কী জাৰি কৰক।
  2. হেডাৰৰ নাম X-API-Key নে Authorization, সেয়া পৰীক্ষা কৰক।
  3. OpenAI-সামঞ্জস্যপূৰ্ণ পথত Authorization ব্যৱহাৰ কৰিলে Bearer prefix পৰীক্ষা কৰক।
CLEVI

ভাষা আৰু অঞ্চল

যন্ত্ৰ-অনূদিত ভাষাসমূহ চিহ্নিত কৰা হৈছে। উপলব্ধতা প্ৰকাশিত ছাইট বাণ্ডল অনুসৰি।

১৩৬ ভাষা

পৰামৰ্শিত

1

প্ৰাচ্য এছিয়া

7

দক্ষিণ-পূব এছিয়া

11

দাক্ষিণাত্য এছিয়া

18

মধ্য এছিয়া

5

মধ্যপ্ৰাচ্য আৰু ককেছাছ

10

পাশ্চাত্য ইউৰোপ আৰু দাক্ষিণাত্য ইউৰোপ

16

সংযুক্ত ৰাজ্য আৰু আয়াৰলেণ্ড

4

উদীচ্য ইউৰোপ

10

মধ্য ইউৰোপ আৰু বাল্কান

14

প্ৰাচ্য ইউৰোপ

5

প্ৰাচ্য আফ্ৰিকা

8

পাশ্চাত্য আফ্ৰিকা আৰু মধ্য আফ্ৰিকা

9

দাক্ষিণাত্য আফ্ৰিকা

8

আমেৰিকাছ্

5

অ’চেনীয়া

5