உங்கள் திட்டத்துடன் API ஐப் பயன்படுத்துதல்
API விசையுடன் HTTP மூலம் Dropstone ஐ அழைக்கவும். இந்த முனையம் OpenAI-இணக்கமானது, உங்கள் கிரெடிட் இருப்பிலிருந்து பயன்பாட்டுக்கு ஏற்ப கட்டணம் வசூலிக்கப்படுகிறது, மேலும் எந்த மொழியிலிருந்தும் செயல்படுகிறது. விசைகள், பிழைகள், விகித வரம்புகள் மற்றும் API என்ன கொண்டு செல்லாது.
Dropstone API என்பது OpenAI-இணக்கமான முனையமாகும், இது உள்நுழைந்த மேற்பரப்பைச் சார்ந்து இருக்கக்கூடாத குறியீட்டிற்கானது: ஒரு CI வேலை, ஒரு serverless செயல்பாடு, வேறொரு மொழியில் உள்ள சேவை. ஒரு விசையை உருவாக்கி, ஒரு கிளையண்டை Dropstone இல் சுட்டிக்காட்டுங்கள், நீங்கள் Chat மற்றும் CLI போன்ற அதே மூன்று மாதிரிகளை அழைக்கிறீர்கள்.
முனையக் குறிப்பு docs.dropstone.io/cli/api இல் உள்ளது. இந்தப் பக்கம் விசைகள், பில்லிங் மற்றும் எதை எதிர்பார்க்கலாம் என்பதை உள்ளடக்குகிறது.
API விசையை உருவாக்கவும்
- உங்கள் டாஷ்போர்டில் அமைப்புகள் என்பதைத் திறக்கவும்.
- API விசைகள் கீழ், விசையை உருவாக்கு என்பதைத் தேர்ந்தெடுத்து அதற்கு ஒரு பெயரைக் கொடுங்கள்.
- விசையை நகலெடுக்கவும். இது
dsk_live_...போல் தெரிகிறது, மேலும் இது ஒருமுறை மட்டுமே காட்டப்படும்.
விசையை கடவுச்சொல்லைப் போல கருதுங்கள்: அதை ஒருபோதும் commit செய்ய வேண்டாம், மேலும் அதை ஒரு உலாவி தொகுப்பில் ஒருபோதும் அனுப்ப வேண்டாம். அதை வைத்திருக்கும் எவரும் அதன் பின்னால் உள்ள இருப்பை செலவிட முடியும். ஒவ்வொரு விசையும் கடைசியாக எப்போது பயன்படுத்தப்பட்டது என்பதை நீங்கள் பார்க்கலாம், மேலும் அதே பக்கத்திலிருந்து அவற்றில் ஏதேனும் ஒன்றை ரத்து செய்யலாம்.
பில்லிங்: பயன்பாட்டுக்கு ஏற்ப செலுத்துங்கள்
API-விசை கோரிக்கைகள் உங்கள் கிரெடிட் இருப்பிலிருந்து பயன்பாட்டுக்கு ஏற்ப கட்டணம் வசூலிக்கப்படுகின்றன. திட்ட கொடுப்பனவுகள் அவற்றுக்கு பொருந்தாது.வாராந்திர கொடுப்பனவு உள்நுழைந்த மேற்பரப்புகளுக்கு சொந்தமானது: Chat, CLI மற்றும் ஒரு உள்ளூர் SDK அமர்வு. API தனித்தனியாக அளவிடப்படுகிறது, எனவே ஒரு குழாயின் போக்குவரத்து நீங்கள் வேலை செய்யும் கொடுப்பனவை ஒருபோதும் சாப்பிடாது, மேலும் Chat இல் ஒரு பரபரப்பான வாரம் குழாயை ஒருபோதும் நிறுத்தாது. டாஷ்போர்டில் பில்லிங் இலிருந்து மேலேற்றவும்.
இருப்பு காலியாக இருக்கும் ஒரு விசை, அதைப் பற்றி சொல்லும் பிழையுடனும், மேலேற்றுவதற்கான இணைப்புடனும் மறுக்கப்படுகிறது, பின்னர் வழங்கப்பட்டு கட்டணம் வசூலிக்கப்படுவதற்கு பதிலாக. API இல் இலவச அடுக்கு இல்லை.
OpenAI-இணக்கமானது
முனையம் OpenAI chat completions வடிவத்தைப் பின்பற்றுகிறது, எனவே பெரும்பாலான தற்போதைய கிளையண்டுகள் அடிப்படை URL மற்றும் விசையை மாற்றுவதன் மூலம் வேலை செய்கின்றன:
import OpenAI from "openai"
const openai = new OpenAI({
baseURL: "https://api.dropstone.io/api/v1",
apiKey: process.env.DROPSTONE_API_KEY,
})
மாதிரிகள் dropstone-fast, dropstone-pro மற்றும் dropstone-heavy; மாதிரியைத் தேர்ந்தெடுக்கவும் பார்க்கவும். HTTP அழைப்பைச் செய்யக்கூடிய எந்த மொழியிலிருந்தும் கோரிக்கைகள் வேலை செய்கின்றன.
API என்ன கொண்டு செல்லாது
முனையம் நிலையற்றது, மேலும் வேண்டுமென்றே அப்படியே உள்ளது:
- நினைவகம் இல்லை. இது உங்கள் கணக்கு நினைவகத்தைப் படிக்காது, மேலும் அது பதிலளிக்கும் எதுவும் அங்கு பதிவு செய்யப்படாது. கடந்த வாரம் நீங்கள் Dropstone க்கு கற்பித்ததைப் பொருட்படுத்தாமல், அதே உள்ளீடு அதே பதிலை அளிக்கிறது.
- கருவிகள் இல்லை, agent loop இல்லை. இது ஒரு chat completion க்கு பதிலளிக்கிறது. குறியீட்டுத் தொகுப்பைப் படிப்பது, கோப்புகளைத் திருத்துவது மற்றும் கட்டளைகளை இயக்குவது SDK உள்ளூர் கிளையண்ட் மற்றும் CLI க்கு சொந்தமானது.
உங்கள் குறியீடு agent மற்றும் அதன் நினைவகத்தைப் பயன்படுத்த விரும்பினால், SDK இன் உள்ளூர் கிளையண்டைப் பயன்படுத்தவும். ஒவ்வொரு மேற்பரப்பிலும் ஒரே நினைவகம் பார்க்கவும்.
விகித வரம்புகள்
கோரிக்கைகள் ஒரு IP க்கு விகித வரம்புக்குட்பட்டவை, சாதாரண பயன்பாட்டை விட அதிகமாக, சேவையைப் பாதுகாக்க. வரம்பைத் தாண்டும் ஒரு வெடிப்பு மறுக்கப்படுகிறது, எனவே சுழற்சியை இறுக்குவதற்கு பதிலாக பின்வாங்கி மீண்டும் முயற்சிக்கவும்.
கோரிக்கைகள் எங்கு செல்கின்றன
API கோரிக்கைகள் அமெரிக்காவில் செயலாக்கப்படுகின்றன, மற்ற எல்லா மேற்பரப்புகளையும் போலவே. உங்கள் கோரிக்கைகள் எங்கு இயங்குகின்றன பார்க்கவும்.
நிறுவனங்கள்
ஒரு நிறுவனத்தின் உறுப்பினர்கள் தங்கள் சொந்த கணக்கின் கீழ் விசைகளை உருவாக்குகிறார்கள், மேலும் ஒரு விசையின் பின்னால் உள்ள இருப்பு விசை உரிமையாளரின்து. நிறுவன நிர்வாகிகள் நிறுவன டாஷ்போர்டில் உறுப்பினர் வாரியாக API பயன்பாட்டைப் பார்க்கலாம், மேலும் ஒரு உறுப்பினர் SCIM மூலம் அகற்றப்படும்போது என்ன நடக்கிறது என்பதைப் போல, அதன் பின்னால் உள்ள கணக்கு செயலிழக்கப்படும்போது ஒரு விசை வேலை செய்வதை நிறுத்துகிறது.
Related articles
- Dropstone SDKA typed TypeScript and JavaScript client for the Dropstone agent, with two entry points: one for headless API calls from CI or a serverless function, one that runs the agent locally with the same account memory as the CLI and Chat.
- Install and run your first sessionInstall the Dropstone SDK, make a headless API call with an API key, and run a local agent session that carries your account memory. Includes streaming, structured output, and using the OpenAI SDK against Dropstone.
- One memory across every surfaceThe account memory that follows you across Dropstone Chat, the CLI, and the SDK, what shares it and what does not, and how to keep an integration's learning out of your own memory.
- Choose a modelDropstone offers three models, Fast, Pro, and Heavy, tuned for different kinds of work. Fast and Pro are available on every plan. Heavy is included with paid plans. Here is how to pick.
- Where your requests runDropstone's servers and the inference providers that run its models are hosted in the United States. Requests are never routed through providers outside the US. What that means for your data.