Ինտեգրում Tokens-ի հետ

Ստուգեք ծառայության Tokens-ը, փորձնական ծրագրի սահմանափակումները և առկա հարցման վիճակը։ Ստորև բերված օրինակները միայն ընթերցման համար են։

Փաստաթղթերի բեռնում…

1. Ընտրովի բանալի՝ կատալոգի համար

2. Ստուգեք Tokens-ը

Tokens փաթեթներ

3. Դիտեք հաշվի վիճակը

Ծառայության Tokens-ը և մոդելի թոքենները տարբեր միավորներ են

Հաշվում ցուցադրվում են ծառայության հասանելի, ամրագրված և ծախսված Tokens-ը։ Փաթեթներն անժամկետ են։ Գանձումը կախված է հարցումից և փաթեթի տրամադրման պահին ամրագրված պայմաններից։

API-ի usage.prompt_tokens, usage.completion_tokens և usage.total_tokens դաշտերը նկարագրում են մոդելի տեխնիկական օգտագործումը։ max_completion_tokens-ը սահմանափակում է մոդելի ելքը, ոչ թե ծառայության Tokens-ի քանակը։ Այս տեխնիկական հաշվիչները մի՛ հանեք հաշվի մնացորդից։

Իրական վճարումները միացված չեն։ Եթե փորձնական ձևակերպումը հասանելի է, այն տրամադրում է փաթեթ ընկերության հաշվին՝ առանց գումար գանձելու։ Հաստատումը հստակ նշվում է որպես փորձնական, ոչ թե բանկային վճարում։

Tokens-ով հարցումների ընթացիկ ռեժիմը

Փորձարկումը լռելյայն անջատված է։ Պահանջվում են սերվերի ակտիվացում, ակտիվ ադմինիստրատոր՝ սերվերի allowlist-ում օգտատիրոջ ճշգրիտ UUID-ով, և մուտքի JWT։ API բանալիներն այս փորձարկման համար չեն աջակցվում։ runtimeSpendingEnabled-ը ցույց է տալիս հաշվի թույլտվությունը, ոչ թե մատակարարի աշխատունակությունը կամ Playground-ից ուղարկելու իրավունքը։

Օպերատորի ռեժիմը սահմանափակվում է POST /v1/chat/completions-ով՝ openai/gpt-4o-mini, մեկ տեքստային JSON պատասխան և ելքի հստակ սահմանաչափ։ Մատակարարների native ուղիները, streaming-ը, tools-ը, պատկերները և մյուս մոդելները Tokens-ի գանձման համար չեն աջակցվում։

Վճարովի POST հարցումներն ուղարկվում են միայն tools/token-pilot-once.mjs-ի միջոցով։ Օպերատորի runner-ը նախքան ուղարկելը պահպանում է մասնավոր մատյանը և փոխանցում X-Token-Request-Id։ Playground-ը միայն դիտման համար է՝ մինչև հարցումների նույնականացման և վերականգնման միջերեսի ներդրումը։

GET /v1/models-ը միայն ընթերցման համար է և կարող է օգտագործել API բանալի։ Կատալոգում մոդելի առկայությունը չի հաստատում Tokens փորձարկման հասանելիությունը կամ մատակարարի պատրաստվածությունը։

Playground՝ միայն դիտում

API-ի բազային URL

https://api.apibridge.am

Վիճակի ստուգում՝ առանց նոր վճարովի հարցման

GET /billing/token-wallet/requests/<saved UUIDv4>-ը կարդում է միայն նույնականացված սեփականատիրոջ առկա գրառումը։ Այն հասանելի է նաև փորձարկումն անջատելուց (OFF) կամ հաշիվը cohort-ից հեռացնելուց հետո՝ ակտիվ մուտքի JWT-ով և հասանելի դրամապանակի ծառայությամբ։ Այն հարցում չի ուղարկում, ամրագրում չի ազատում և մոդելի պատասխանը չի վերականգնում։

404 / token_wallet_request_not_found նշանակում է, որ պահպանված գրառում չի գտնվել։ Հարցումը կարող է դեռ կատարվել․ սա չի ապացուցում մատակարարի ծախսի բացակայությունը կամ Tokens-ի ազատումը։ Պահպանեք մատյանը և ստուգեք վիճակը․ POST-ը կրկին մի՛ ուղարկեք։

Օրինակները միայն ընթերցման համար են․ վերականգնման համար օգտագործեք մուտքի JWT-ն և օպերատորի մատյանում պահպանված կանոնական UUIDv4-ը, որը նախապես ուղարկվել է որպես X-Token-Request-Id։ Նախորդ հարցումը ստուգելու համար նոր ID մի՛ ստեղծեք․ JWT-ն և մասնավոր մատյանը մի՛ փոխանցեք ուրիշներին։

Մոդելների կատալոգի ընթերցում

curl "https://api.apibridge.am/v1/models" \
  -H "Authorization: Bearer $APIBRIDGE_API_KEY"

Առկա հարցման վիճակի ընթերցում

curl "https://api.apibridge.am/billing/token-wallet/requests/$APIBRIDGE_TOKEN_REQUEST_ID" \
  -H "Authorization: Bearer $APIBRIDGE_LOGIN_JWT"

JavaScript․ միայն վիճակի ընթերցում

const requestId = process.env.APIBRIDGE_TOKEN_REQUEST_ID;
const jwt = process.env.APIBRIDGE_LOGIN_JWT;
if (!requestId || !jwt) throw new Error('saved_request_id_and_jwt_required');
const response = await fetch('https://api.apibridge.am/billing/token-wallet/requests/' + encodeURIComponent(requestId), {
  method: 'GET',
  headers: {
    Authorization: 'Bearer ' + jwt,
  },
  cache: 'no-store',
});
const result = await response.json();
if (response.status === 404) throw new Error('status_unknown_do_not_resend');
if (!response.ok) throw new Error(result.error?.code || 'status_unavailable');
console.log(result.state, result.spentTokenMicros);

Մի՛ կրկնեք անորոշ հարցումները

Անջատեք SDK-ի, HTTP-ի և ցանցային սխալների ավտոմատ կրկնությունները։ HTTP 422 / token_wallet_execution_in_doubt կամ x-should-retry:false նշանակում են՝ կանգ առնել և ստուգել հարցումը։ Պատասխանի կորստի դեպքում մատակարարը կարող էր կատարել հարցումը․ սպասման ժամկետի ավարտը չի ապացուցում Tokens-ի ազատումը։

Պահպանված ID-ով ստուգեք հարցման վիճակը, իսկ պատմության մեջ՝ ծառայության Tokens-ը։ reserved/dispatched/in_doubt վիճակները պահպանում են ամրագրումը, committed-ը հաստատված գանձում է, released-ը ազատում է չօգտագործված ամրագրումը։ Վերականգնումը GET է, ոչ թե նոր POST կամ հարցման նոր ID։

Հարցման արդյունքներ

Կոդ	Ինչ անել
`401 / 403`	Վերականգնման համար անհրաժեշտ է ակտիվ մուտքի JWT։ Փորձարկման հարցում ուղարկելու համար նաև պահանջվում է ակտիվ ադմինիստրատոր՝ սերվերի allowlist-ում ճշգրիտ UUID-ով․ API բանալին չի փոխարինում JWT-ին։
`404 · token_wallet_request_not_found`	404 / token_wallet_request_not_found նշանակում է, որ պահպանված գրառում չի գտնվել։ Հարցումը կարող է դեռ կատարվել․ սա չի ապացուցում մատակարարի ծախսի բացակայությունը կամ Tokens-ի ազատումը։ Պահպանեք մատյանը և ստուգեք վիճակը․ POST-ը կրկին մի՛ ուղարկեք։
`token_wallet_route_unsupported token_wallet_execution_unavailable`	Ուղին, մոդելը, հաշիվը կամ անհրաժեշտ կարգավորումները հասանելի չեն։ Ստուգեք հասանելիությունը․ մի՛ միացրեք ավտոմատ կրկնությունները։
`422 · token_wallet_execution_in_doubt`	Հարցումն ինքնաբերաբար կրկին մի՛ ուղարկեք։ Նախ ստուգեք դրա վիճակը և ամրագրված Tokens-ը։
`token_wallet_request_not_completed`	Ավարտված պատասխան չի ստացվել։ Նոր գործողությունից առաջ ստուգեք հարցման վիճակը։