ChatGetz API ವಿಕಸನಕಾರರಿಗಾಗಿ

ತ್ವರಿತ ಆರಂಭ

1. ಪ್ರವೇಶಿಸಿ ಮತ್ತು ಡೇಷ್‌ಬೋರ್ಡ್ → API ಕೀಲಿಕೈಗಳನ್ನು ತೆರೆಯಿರಿ.
2. ನಿಮಗೆ ಬೇಕಾದ ಅನುಮತಿಗಳೊಂದಿಗೆ ಒಂದು ಕೀಲಿಯನ್ನು ರಚಿಸಿ ಮತ್ತು ಅದನ್ನು ಕಾಪಿ ಮಾಡಿ (ಇದು ಕೇವಲ ಒಮ್ಮೆ ಮಾತ್ರ ತೋರಿಸುತ್ತದೆ).
3. ಅದನ್ನು Authorization ಹೆಡರಿನಲ್ಲಿ ಕಳುಹಿಸಬೇಕಾಗಿದೆ: Bearer cgk_…

curl https://www.chatgetz.uz/api/v1/account/balance \
  -H "Authorization: Bearer $CHATGETZ_API_KEY"

curl https://www.chatgetz.uz/api/v1/ai/generate \
  -H "Authorization: Bearer $CHATGETZ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f0c6f5e-order-42" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "prompt": "Write a 60-word description for a cotton kids hoodie",
    "instructions": "Answer in Uzbek (Latin script)."
  }'

ಅನುಮೋದನೆ ಮತ್ತು ವ್ಯಾಪ್ತಿಗಳು

ಪ್ರತಿಯೊಂದು ಕೋರಿಕೆ Authorization: Bearer cgk_… (ಅಥವಾ X-API-Key) ನಲ್ಲಿ ಒಂದು ವೈಯಕ್ತಿಕ API ಕೀಲಿಯನ್ನು ಹೊಂದಿರಬೇಕು. ಪ್ರತಿಯೊಂದು ಕೀಲಿಗೂ ಅದರದೇ ಆದ ಅನುಮತಿಗಳು (ವ್ಯಾಪ್ತಿ) ಮತ್ತು ದರ ಮಿತಿಗಳಿದ್ದು, ಯಾವಾಗ ಬೇಕಾದರೂ ರದ್ದುಗೊಳಿಸಬಹುದಾಗಿದೆ.

) ಮತ್ತು ಪ್ಲೇಟ್ಫಾರ್ಮ್ ಸಂಯೋಜನೆಯಲ್ಲಿ ಇರಿಸಿ, ಯಾವಾಗಲೂ ಸಾರ್ವಜನಿಕ ಮುಂಭಾಗದ ಕೊಡುಗೆಯಲ್ಲಿ ಇರಬೇಡಿ. ChatGetz ಪ್ರತಿಯೊಂದು ಕೀಲಿಯಲ್ಲಿ ಕೇವಲ ಒಂದು SHA-256 ಹ್ಯಾಶ್ ಅನ್ನು ಮಾತ್ರ ಸಂಗ್ರಹಿಸುತ್ತದೆ.

ಮಿತಿಗಳು ಮತ್ತು ಬೆಲೆ

• Global Pro: ಅನಿಯಮಿತ API ಕೋರಿಕೆಗಳು.
• Basic: ಪ್ರತಿ ತಿಂಗಳೂ 1,000 ಕೋರಿಕೆಗಳು (ತಾಶ್ಕೆಂಟ್ ಸಮಯದ ಪ್ರಕಾರ, ಮೊದಲ ದಿನ ಮರಳಿ ಸ್ಥಾಪನೆ).
• ಖಾಸಗಿ ಸಂಸ್ಥೆಗಳಿಗೆ API ಸಂಪರ್ಕವನ್ನು ನೀಡಲಾಗುವುದು.
• ಪ್ರತಿಯೊಂದು ಕೀಲಿಗೂ ಅದರದ್ದೇ ಆದ ವೇಗ ಮಿತಿ (ನಿಮಿಷಕ್ಕೆ 10-120 ಕೋರಿಕೆಗಳು). ಮಿತಿಯ ಹೊರತಾಗಿಯೂ API ಒಂದು Retry-After ಹೆಡರ್ ದೊಂದಿಗೆ 429 ಗೆ ಉತ್ತರಿಸುತ್ತದೆ.
• AI ಪಠ್ಯ ಉತ್ಪಾದನೆಗೆ ಸಾರ್ವಜನಿಕ ಬೆಲೆಪಟ್ಟಿಯಂತೆ ಚಾರ್ಜ್ ಮಾಡಲಾಗುತ್ತದೆ: ಮೊದಲು ನಿಮ್ಮ ಮಾಸಿಕ AI ಅನುದಾನದಿಂದ, ನಂತರ ನಿಮ್ಮ ChatGetz ಬ್ಯಾಲೆನ್ಸ್ನಿಂದ.
• AI ಕೋರಿಕೆಗಳೊಂದಿಗೆ ಒಂದು Idempotency-Key ಹೆಡರ್ ಅನ್ನು ಕಳುಹಿಸಿ: ಅದೇ ಕೀಲಿಯನ್ನು ಬಳಸಿ ಪುನಃ ಪ್ರಯತ್ನಿಸಿದಾಗ ಎರಡು ಬಾರಿ ಶುಲ್ಕ ವಿಧಿಸುವುದಿಲ್ಲ.

ಅಂತ್ಯ

• get/api/v1/account/balancePlan, balance, included AI allowance and API quotaaccount:read
• get/api/v1/modelsಪಠ್ಯ ಮಾದರಿಗಳು ಮತ್ತು ನಿಮ್ಮ ಕೀಲಿಗೆ ಅವುಗಳ ಲಭ್ಯತೆai:generate
• post/api/v1/ai/generateಪಠ್ಯವನ್ನು ರಚಿಸಿ; ಉಳಿತಾಯದಿಂದ ಪಾವತಿಸಲಾಗುತ್ತದೆ (ಅನುದಾನ ಮೊದಲು ಸೇರಿಸಲಾಗಿದೆ)ai:generate
• get/api/v1/market/listingsನಿಮ್ಮ ChatGetz ಮಾರುಕಟ್ಟೆ ವಿವರಗಳುmarket:read
• post/api/v1/market/listingsಒಂದು ಮಾರುಕಟ್ಟೆ ಪಟ್ಟಿಯನ್ನು ರಚಿಸಿ (ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ ಒಂದು ಕರಡು)market:write
• post/api/v1/ingest/eventsಪ್ಲಗ್ಇನ್ (ವೆಬ್ಹುಕ್) ನಿಂದ ಆದೇಶ ಅಥವಾ ಮಾರ್ಗವನ್ನು ಪಡೆಯಿರಿingest:write
• get/api/v1/openapi.jsonThe OpenAPI 3.1 specification of this API

ಪ್ಲಗ್‌ಇನ್‌ಗಳು ಹೊಸ ಆದೇಶಗಳನ್ನು ಒತ್ತುತ್ತವೆ ಮತ್ತು POST /api/v1/ingest/events. ಗೆ ಕಾರಣವಾಗುತ್ತವೆ.

curl https://www.chatgetz.uz/api/v1/ingest/events \
  -H "Authorization: Bearer $CHATGETZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "order", "source": "woocommerce", "externalId": "1042",
    "customer": { "name": "Aziza", "phone": "+998901234567" },
    "total": { "amount": "249000", "currency": "UZS" },
    "items": [{ "name": "Hoodie", "quantity": 1, "price": "249000" }]
  }'

ದೋಷಗಳು

ದೋಷಗಳು ಸ್ಥಿರವಾದ ಯಂತ್ರ ಓದಬಹುದಾದ ಕೋಡ್ ಮತ್ತು ಇಂಗ್ಲೀಷ್ ಸಂದೇಶದೊಂದಿಗೆ JSON ಆಗಿವೆ. ಕೋಡ್ ಮೇಲೆ ನಿಮ್ಮ ಸಮಗ್ರತೆಯನ್ನು ನಿರ್ಮಿಸಿ.

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly Basic API quota exhausted. ..."
  }
}

ಪ್ಲಗ್‌ಇನ್‌ಗಳು

ಎಲ್ಲಾ ಪ್ಲಗಿನ್ ಗಳು ಓಪನ್ ಸೋರ್ಸ್ (ಜಿಪಿಎಲ್-ಸಮ್ಮತ) ಮತ್ತು ನಿಮ್ಮ API ಕೀಲಿಯನ್ನು ಬಳಸುತ್ತವೆ. ಈ ಕೀಲಿಯನ್ನು ಪ್ಲಗಿನ್ ಸಂಯೋಜನೆಯಲ್ಲಿ ಶೇಖರಿಸಿಡಲಾಗುತ್ತದೆ, ಯಾವಾಗಲೂ ಕೋಡ್‌ನಲ್ಲಿ ಅಲ್ಲ.