HTTP API

Dropstone HTTP API ஆனது CLI பயன்படுத்தும் அதே மூன்று மாடல்களுக்கு — Dropstone Fast, Pro, மற்றும் Heavy — OpenAI-இணக்கமான இடைமுகம் மூலம் நிரலாக்க அணுகலை வழங்குகிறது. ஒரு விசை, ஒரு பில், மூன்று மாடல் குடும்பங்கள்.

உங்கள் சொந்த குறியீட்டிலிருந்து Dropstone ஐ அழைக்க விரும்பும்போது API ஐப் பயன்படுத்தவும்: CI பைப்லைன்கள், உள் கருவிகள், ஆட்டோமேஷன், அல்லது மூன்றாம் தரப்பு பயன்பாடுகள். ஊடாடும் குறியீட்டுக்கு, அதற்கு பதிலாக CLI ஐப் பயன்படுத்தவும்.

அடிப்படை URL

https://api.dropstone.io/api/v1

அனைத்து எண்ட்பாயிண்ட்களும் /api/v1 இன் கீழ் பொருத்தப்பட்டுள்ளன. பாதை பதிப்பிடப்பட்டுள்ளது, எனவே எதிர்கால மாற்றங்கள் /api/v2 இன் கீழ் உங்கள் குறியீட்டை சீர்குலைக்காமல் வரும்.

அங்கீகாரம்

ஒவ்வொரு கோரிக்கையும் Authorization தலைப்பில் API விசையை உள்ளடக்கியிருக்க வேண்டும்:

Authorization: Bearer dsk_live_<your-key>

விசையை உருவாக்கவும்

1. dropstone.io/dashboard இல் உள்நுழைக
2. அமைப்புகள் → API ஐத் திறக்கவும்
3. விசையை உருவாக்கு என்பதைக் கிளிக் செய்து, அதற்கு ஒரு பெயரைக் கொடுங்கள் (எ.கா. Production CI)
4. முழு விசையை நகலெடுக்கவும் — அதை ஒருமுறை மட்டுமே பார்ப்பீர்கள்

விசைகள் dsk_live_<43 எழுத்துகள்> போல இருக்கும். அவற்றை ஒரு ரகசிய மேலாளரில் அல்லது DROPSTONE_API_KEY சூழல் மாறியில் சேமிக்கவும்.

விசையை ரத்து செய்தல்

அதே அமைப்புகள் → API பக்கத்திலிருந்து ரத்து செய்யவும். ரத்து செய்வது உடனடியானது; விசையுடன் நடந்து கொண்டிருக்கும் கோரிக்கைகள் தொடரும், புதிய கோரிக்கைகள் 401 பெறும்.

கிரெடிட்கள் & பில்லிங்

API ஆனது கிரெடிட் இருப்புக்கு எதிராக பயன்பாட்டுக்கு-செலுத்தும் முறையில் உள்ளது. API மேற்பரப்பில் இலவச அடுக்கு அல்லது சந்தா இல்லை.

• dropstone.io/dashboard/billing இல் கிரெடிட்களை வாங்கவும். Stripe செக்அவுட்டை கையாளுகிறது.
• ஒவ்வொரு கோரிக்கையும் அதன் செலவை உங்கள் creditBalance இலிருந்து கழிக்கிறது.
• creditBalance $0 ஆக குறையும்போது, நீங்கள் மேலேற்றும் வரை API 402 போதுமான கிரெடிட்கள் இல்லை ஐ திருப்பி அனுப்புகிறது.
• சந்தா கிரெடிட்கள் (Pro/Teams மாதாந்திர கொடுப்பனவு) மற்றும் இலவச கோரிக்கை ஒதுக்கீடுகள் API விசை கோரிக்கைகளுக்கு பொருந்தாது.

விலை நிர்ணயம்

விலை நிர்ணயம் உண்மையான அனுமான செலவு 30% மார்க்அப் (1.3x) உடன் அனுப்பப்படுகிறது. முழு ஒவ்வொரு கோரிக்கை செலவும் பதிலின் usage.cost புலத்தில் திருப்பி அனுப்பப்படுகிறது, எனவே ஒவ்வொரு கட்டணத்தையும் நீங்கள் சரிபார்க்கலாம்.

தற்காலிக சேமிப்பு செய்யப்பட்ட prompt டோக்கன்கள் வழங்குநரின் தற்காலிக சேமிப்பு விகிதத்தில் (பொதுவாக சாதாரண உள்ளீட்டு விகிதத்தில் ~5–10%) கட்டணம் விதிக்கப்படுகின்றன, எனவே பல-திருப்ப உரையாடல்கள் படிப்படியாக மலிவாகின்றன.

மாடல்கள்

GET /api/v1/models

கிடைக்கக்கூடிய மூன்று அடுக்குகளை பட்டியலிடவும்.

curl https://api.dropstone.io/api/v1/models \
  -H "Authorization: Bearer $DROPSTONE_API_KEY"

பதில்:

{
  "object": "list",
  "data": [
    { "id": "dropstone-fast",  "object": "model", "display_name": "Dropstone Fast",  "owned_by": "dropstone" },
    { "id": "dropstone-pro",   "object": "model", "display_name": "Dropstone Pro",   "owned_by": "dropstone" },
    { "id": "dropstone-heavy", "object": "model", "display_name": "Dropstone Heavy", "owned_by": "dropstone" }
  ]
}

அரட்டை நிறைவுகள்

POST /api/v1/chat/completions

OpenAI-இணக்கமான அரட்டை நிறைவுகள். நீங்கள் எந்த OpenAI-இணக்கமான API ஐப் பயன்படுத்தியிருந்தால், இது ஒரே மாதிரியாக இருக்கும்.

கோரிக்கை உடல்

| புலம் | வகை | தேவை | விளக்கம் | |---|---|---| | model | string | ஆம் | dropstone-fast, dropstone-pro, dropstone-heavy இல் ஒன்று | | messages | array | ஆம் | role மற்றும் content உடன் செய்தி பொருள்களின் பட்டியல் | | stream | boolean | இல்லை | true ஆக இருக்கும்போது, Server-Sent Events ஐ திருப்பி அனுப்புகிறது. இயல்புநிலை false | | temperature | number | இல்லை | மாதிரி வெப்பநிலை, 0..2. இயல்புநிலை மாடல் சார்ந்தது | | max_tokens | number | இல்லை | வெளியீட்டு டோக்கன்களுக்கான வரம்பு | | tools | array | இல்லை | செயல்பாடு-அழைப்பு கருவி திட்டங்கள், OpenAI வடிவம் | | tool_choice | string \| object | இல்லை | "auto", "none", அல்லது ஒரு குறிப்பிட்ட கருவி |

எடுத்துக்காட்டு: எளிய அரட்டை

curl https://api.dropstone.io/api/v1/chat/completions \
  -H "Authorization: Bearer $DROPSTONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dropstone-fast",
    "messages": [
      {"role": "user", "content": "Write a haiku about debugging."}
    ]
  }'

பதில்

{
  "id": "gen-1779530142-EfBhlhO1U2frV6tvMgKV",
  "object": "chat.completion",
  "created": 1779530142,
  "model": "dropstone-fast",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Stack trace at midnight..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 11,
    "completion_tokens": 23,
    "total_tokens": 34,
    "cost": 0.0000098
  }
}

usage.cost புலம் USD இல் கட்டணம் விதிக்கப்பட்ட தொகை — இந்த கோரிக்கைக்கு உங்கள் கிரெடிட் இருப்பிலிருந்து கழிக்கப்பட்டது (உண்மையான வழங்குநர் செலவு × 1.3 மார்க்அப்).

ஸ்ட்ரீமிங்

டோக்கன் துண்டுகளின் Server-Sent Events ஸ்ட்ரீமைப் பெற "stream": true ஐ அமைக்கவும். ஸ்ட்ரீம் data: [DONE] வரியுடனும் முழு usage தொகுதியைக் கொண்ட இறுதி துண்டுடனும் முடிவடைகிறது.

curl https://api.dropstone.io/api/v1/chat/completions \
  -H "Authorization: Bearer $DROPSTONE_API_KEY" \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "dropstone-fast",
    "stream": true,
    "messages": [{"role": "user", "content": "Count to 5."}]
  }'

OpenAI SDK இணக்கத்தன்மை

மேற்பரப்பு OpenAI-இணக்கமானது என்பதால், base_url ஐ மேலெழுதுவதன் மூலம் அதிகாரப்பூர்வ OpenAI SDK ஐப் பயன்படுத்தலாம்:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.dropstone.io/api/v1",
    api_key=os.environ["DROPSTONE_API_KEY"],
)

resp = client.chat.completions.create(
    model="dropstone-fast",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

பிழை குறியீடுகள்

402 பதில் வடிவம்

{
  "error": "Insufficient credits",
  "balance": 0,
  "message": "Your credit balance is empty. Top up at https://dropstone.io/dashboard/billing to continue.",
  "topUpUrl": "https://dropstone.io/dashboard/billing"
}

விகித வரம்புகள்

இன்று API இல் கடுமையான விகித வரம்புகள் அமல்படுத்தப்படவில்லை. ஒவ்வொரு விசை பயன்பாட்டு அடுக்குகள் மற்றும் தினசரி செலவு வரம்புகள் திட்டமிடப்பட்டுள்ளன — அவை வெளியிடப்படும்போது, உங்கள் தற்போதைய விசைகள் வாழ்நாள் செலவின் அடிப்படையில் தானாக அடுக்கப்படும், OpenAI இன் அடுக்கு முறையைப் போல.

இப்போதைக்கு, உங்கள் பயன்பாட்டில் usage.cost புலத்தைக் கண்காணிப்பதன் மூலம் ஒவ்வொரு விசை பட்ஜெட்டுகளை நீங்களே அமைக்கவும்.

பரிந்துரைக்கப்பட்ட நடைமுறைகள்

• சூழல் மாறிகளைப் பயன்படுத்தவும், உள்ளமைக்கப்பட்ட விசைகளை ஒருபோதும் பயன்படுத்த வேண்டாம்: DROPSTONE_API_KEY=dsk_live_....
• ஒவ்வொரு சேவைக்கும் ஒரு விசை, எல்லா இடங்களிலும் ஒரே விசையைப் பகிர வேண்டாம். ஒரு சேவை சமரசம் செய்யப்படும்போது ரத்து செய்வது எளிது.
• usage.cost ஐ கவனிக்கவும் பதில்களில் நிகழ்நேர செலவைக் கண்காணிக்க.
• 402 ஐ நேர்த்தியாக கையாளவும் — உங்கள் பயன்பாடு அதைக் கண்டறிந்து மீண்டும் முயற்சிப்பதற்கு பதிலாக மேலேற்ற CTA ஐக் காட்ட வேண்டும்.
• மீண்டும் மீண்டும் ஒரே மாதிரியான கோரிக்கைகளுக்கு பதில்களை தற்காலிக சேமிப்பில் வைக்கவும் உங்கள் பக்கத்தில் — நாங்கள் மாடல் மட்டத்தில் தற்காலிக சேமிப்பு செய்கிறோம், ஆனால் எங்களை அடைவதற்கு முன் குறுக்குவழி செய்வதன் மூலம் முழு மார்க்அப்பையும் நீங்கள் சேமிக்கிறீர்கள்.

CLI மற்றும் SDK இலிருந்து வேறுபாடுகள்

| மேற்பரப்பு | அங்கீகாரம் | விலை மாதிரி | மாடல்கள் | பயன்பாட்டு வழக்கு | |---|---|---|---| | HTTP API (இந்த பக்கம்) | API விசை | கிரெடிட் இருப்பிலிருந்து பயன்பாட்டுக்கு-செலுத்தும் | Fast / Pro / Heavy | CI, ஆட்டோமேஷன், ஒருங்கிணைப்புகள் | | CLI (ஆவணங்கள்) | ஊடாடும் உள்நுழைவு | சந்தா + கிரெடிட் இருப்பு | அதே மூன்று + இலவச திறந்த மூல மாடல்கள் | ஒரு டெர்மினலில் தினசரி குறியீடு | | JS SDK (ஆவணங்கள்) | உள்ளூர் CLI ஐ உருவாக்கி, அதன் அங்கீகாரத்தைப் பெறுகிறது | CLI போலவே | CLI போலவே | ஒரு Node பயன்பாட்டில் முகவரை உட்பொதித்தல் |

CI அல்லது சேவையகத்தில் தலைமையற்ற நிரலாக்க அணுகலை நீங்கள் விரும்பினால், HTTP API தான் சரியான மேற்பரப்பு. SDK என்பது ஒரு Node செயல்பாட்டில் ஊடாடும் முகவரை உட்பொதிப்பதற்கானது, அங்கு ஒரு மனிதர் இன்னும் வளையத்தில் இருக்கிறார்.

விரைவில் வருகிறது

இவை சாலை வரைபடத்தில் உள்ளன மற்றும் அதே /api/v1 பெயர்வெளியின் கீழ் வரும்:

• POST /api/v1/agent/run — முகவர் வளைய எண்ட்பாயிண்ட். ஒரு பணியை அனுப்புங்கள், முடிக்கப்பட்ட diff ஐப் பெறுங்கள். சேவையக பக்க பல-திருப்ப வளையம் உள்ளமைக்கப்பட்ட கருவிகளுடன் (கோப்பு திருத்தம், வலை தேடல், குறியீடு செயலாக்கம்). ஒவ்வொரு பணிக்கும் தட்டையான விலை.
• POST /api/v1/memory/store + GET /api/v1/memory/query — Qdrant வழியாக நிலைத்த நினைவகம். அழைப்புகளுக்கு இடையில் நீடிக்கும் முகவர் சூழல்.
• MCP கருவி உட்செலுத்தல் — முகவர் கோரிக்கைகளில் உங்கள் சொந்த MCP சேவையக URL களை சேர்க்கவும், முகவர் அவற்றை சொந்த கருவிகளாக அழைக்கிறது.
• ஒவ்வொரு விசை செலவு வரம்புகள் — டாஷ்போர்டிலிருந்து ஒவ்வொரு விசைக்கும் தினசரி $ வரம்பை அமைக்கவும். CI பாதுகாப்பு வலை.

GitHub களஞ்சியத்தை நட்சத்திரமிடுங்கள் அல்லது அவை வெளியிடப்படும்போது தெரிந்துகொள்ள மாற்றப்பதிவை பார்க்கவும்.