ਆਪਣੀ ਐਪ ਵਿੱਚ Claude API ਕਿਵੇਂ ਜੋੜੀਏ
Claude API ਜੋੜਨ ਲਈ, Anthropic ਦੇ Claude Console ਵਿੱਚ ਇੱਕ API ਕੁੰਜੀ ਬਣਾਓ, ਉਸਨੂੰ ਸਰਵਰ-ਸਾਈਡ ਸੀਕ੍ਰੇਟ ਵਜੋਂ ਸੰਭਾਲੋ (ਆਮ ਤੌਰ 'ਤੇ ANTHROPIC_API_KEY), ਅਤੇ Anthropic ਦੇ ਅਧਿਕਾਰਤ SDK ਵਿੱਚੋਂ ਕਿਸੇ ਇੱਕ ਨਾਲ ਆਪਣੇ ਸਰਵਰ ਦੇ ਕਿਸੇ ਰੂਟ ਤੋਂ Messages API ਨੂੰ ਕਾਲ ਕਰੋ। ਹਰ ਬੇਨਤੀ ਇੱਕ model ਦਾ ਨਾਮ ਲੈਂਦੀ ਹੈ, max_tokens ਸੈੱਟ ਕਰਦੀ ਹੈ (ਸਭ ਤੋਂ ਲੰਮਾ ਜਵਾਬ ਜੋ ਤੁਸੀਂ ਸਵੀਕਾਰ ਕਰੋਗੇ), ਅਤੇ ਗੱਲਬਾਤ ਨੂੰ messages ਵਜੋਂ ਭੇਜਦੀ ਹੈ, ਜਿਸ ਵਿੱਚ ਤੁਹਾਡੀਆਂ ਹਦਾਇਤਾਂ ਇੱਕ ਵੱਖਰੇ system ਪ੍ਰੋਂਪਟ ਵਿੱਚ ਹੁੰਦੀਆਂ ਹਨ। ਖਰਚ ਸੀਮਾ ਸੈੱਟ ਕਰੋ, ਲੰਮੇ ਜਵਾਬ ਸਟ੍ਰੀਮ ਕਰੋ, ਅਤੇ ਰੇਟ-ਲਿਮਿਟ (429) ਤੇ ਓਵਰਲੋਡ (529) ਗਲਤੀਆਂ ਨੂੰ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ਾਂ ਨਾਲ ਸੰਭਾਲੋ।
ਇਹ ਗਾਈਡ ਸੈੱਟਅੱਪ, ਇੱਕ ਸੁਰੱਖਿਅਤ ਬੇਨਤੀ ਪ੍ਰਵਾਹ, ਇੱਕ AI ਬਿਲਡਰ ਲਈ ਪ੍ਰੋਂਪਟ ਅਤੇ ਜਿਨ੍ਹਾਂ ਗਲਤੀਆਂ ਲਈ ਤਿਆਰੀ ਕਰਨੀ ਹੈ, ਉਨ੍ਹਾਂ ਨੂੰ ਕਵਰ ਕਰਦੀ ਹੈ। Anthropic ਦੇ ਵੇਰਵੇ ਸਤੰਬਰ 2026 ਤੱਕ ਦੇ ਉਨ੍ਹਾਂ ਦੇ ਦਸਤਾਵੇਜ਼ਾਂ ਤੋਂ ਲਏ ਗਏ ਹਨ। ਟੋਕਨ ਅਤੇ ਕੀਮਤ ਆਮ ਤੌਰ 'ਤੇ ਕਿਵੇਂ ਕੰਮ ਕਰਦੇ ਹਨ, ਇਸ ਲਈ LLM APIs ਕਿਵੇਂ ਵਰਤੀਏ ਦੇਖੋ।
ਇਸ ਨਾਲ ਤੁਸੀਂ ਕੀ ਬਣਾ ਸਕਦੇ ਹੋ
- ਚੈਟ ਸਹਾਇਕ ਅਤੇ ਹੈਲਪ ਵਿਜੇਟ (AI ਚੈਟਬੋਟ ਐਪ ਕਿਵੇਂ ਬਣਾਈਏ)
- ਸਾਰ, ਦੁਬਾਰਾ ਲਿਖਤ ਅਤੇ ਡਰਾਫਟ ਕੀਤੇ ਜਵਾਬ
- ਦਸਤਾਵੇਜ਼ਾਂ, ਈਮੇਲਾਂ ਅਤੇ ਫਾਰਮਾਂ ਵਿੱਚੋਂ ਫੀਲਡ ਕੱਢਣੇ
- ਤੁਹਾਡੀ ਆਪਣੀ ਸਮੱਗਰੀ ਤੋਂ ਸਵਾਲਾਂ ਦੇ ਜਵਾਬ ਦੇਣੇ
- ਏਜੰਟ ਜੋ tool use ਰਾਹੀਂ ਤੁਹਾਡੀ ਐਪ ਦੇ ਫੰਕਸ਼ਨ ਕਾਲ ਕਰਦੇ ਹਨ
ਹੋਰ ਵਿਚਾਰਾਂ ਲਈ, ਆਪਣੀ ਐਪ ਵਿੱਚ AI ਫੀਚਰ ਕਿਵੇਂ ਜੋੜੀਏ ਦੇਖੋ।
Messages API ਸੰਖੇਪ ਵਿੱਚ
Anthropic ਦੇ API ਹਵਾਲੇ ਅਨੁਸਾਰ, ਇੱਕ ਬੇਨਤੀ https://api.anthropic.com/v1/messages 'ਤੇ POST ਹੁੰਦੀ ਹੈ, ਜਿਸ ਵਿੱਚ:
| ਹਿੱਸਾ | ਇਹ ਕੀ ਹੈ |
|---|---|
x-api-key ਹੈਡਰ | ਤੁਹਾਡੀ API ਕੁੰਜੀ |
anthropic-version ਹੈਡਰ | API ਵਰਜਨ, ਉਦਾਹਰਨ ਲਈ 2023-06-01 |
model (ਲੋੜੀਂਦਾ) | ਕਿਹੜਾ Claude ਮਾਡਲ ਵਰਤਣਾ ਹੈ |
max_tokens (ਲੋੜੀਂਦਾ) | ਜਵਾਬ ਵਿੱਚ ਵੱਧ ਤੋਂ ਵੱਧ ਟੋਕਨ; ਮਾਡਲ ਇਸ ਤੋਂ ਪਹਿਲਾਂ ਵੀ ਰੁਕ ਸਕਦਾ ਹੈ |
messages (ਲੋੜੀਂਦਾ) | ਗੱਲਬਾਤ: user ਅਤੇ assistant ਵਾਰੀ-ਵਾਰੀ |
system (ਵਿਕਲਪਿਕ) | ਹਦਾਇਤਾਂ ਜੋ ਪੂਰੀ ਗੱਲਬਾਤ 'ਤੇ ਲਾਗੂ ਹੁੰਦੀਆਂ ਹਨ |
stream (ਵਿਕਲਪਿਕ) | true ਸੈੱਟ ਕਰੋ ਤਾਂ ਜਵਾਬ ਲਿਖਦੇ ਸਮੇਂ ਹੀ server-sent events ਰਾਹੀਂ ਮਿਲਦਾ ਹੈ |
API ਸਟੇਟਲੈੱਸ ਹੈ: ਗੱਲਬਾਤ ਜਾਰੀ ਰੱਖਣ ਲਈ, ਹਰ ਬੇਨਤੀ ਨਾਲ ਪਿਛਲੀਆਂ ਵਾਰੀਆਂ ਦੁਬਾਰਾ ਭੇਜੋ। ਇਸੇ ਕਰਕੇ ਲੰਮੀਆਂ ਚੈਟਾਂ ਹਰ ਸੁਨੇਹੇ 'ਤੇ ਵੱਧ ਖਰਚ ਕਰਦੀਆਂ ਹਨ।
Anthropic Python, TypeScript, C#, Go, Java, PHP ਅਤੇ Ruby ਲਈ ਅਧਿਕਾਰਤ SDK ਪ੍ਰਕਾਸ਼ਿਤ ਕਰਦਾ ਹੈ। ਇਹ ਹੈਡਰ ਸੈੱਟ ਕਰਦੇ ਹਨ, ਜਵਾਬ ਪਾਰਸ ਕਰਦੇ ਹਨ, ਅਤੇ ਸਟ੍ਰੀਮਿੰਗ ਦਾ ਸਮਰਥਨ ਕਰਦੇ ਹਨ। ਕੋਈ ਖਾਸ ਕਾਰਨ ਨਾ ਹੋਵੇ ਤਾਂ ਕੱਚੇ HTTP ਦੀ ਥਾਂ ਇਨ੍ਹਾਂ ਵਿੱਚੋਂ ਕੋਈ ਵਰਤੋ।
ਮਾਡਲ ਚੁਣਨਾ
Anthropic ਕਈ Claude ਮਾਡਲ ਦਿੰਦਾ ਹੈ ਜੋ ਸਮਰੱਥਾ, ਗਤੀ ਅਤੇ ਕੀਮਤ ਵਿਚਕਾਰ ਸੰਤੁਲਨ ਬਣਾਉਂਦੇ ਹਨ, ਅਤੇ ਇਹ ਸੂਚੀ ਬਦਲਦੀ ਰਹਿੰਦੀ ਹੈ। ਸਭ ਤੋਂ ਛੋਟਾ ਮਾਡਲ ਚੁਣੋ ਜੋ ਤੁਹਾਡਾ ਕੰਮ ਚੰਗੀ ਤਰ੍ਹਾਂ ਕਰੇ, ਉਸਨੂੰ ਅਸਲ ਉਦਾਹਰਨਾਂ 'ਤੇ ਪਰਖੋ, ਅਤੇ ਮਾਡਲ ID ਨੂੰ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਿੱਚ ਰੱਖੋ ਤਾਂ ਜੋ ਕੋਡ ਬਦਲੇ ਬਿਨਾਂ ਬਦਲ ਸਕੋ। ਮੌਜੂਦਾ ਵਿਕਲਪਾਂ ਅਤੇ ਦਰਾਂ ਲਈ Anthropic ਦੇ ਮਾਡਲ ਅਤੇ ਕੀਮਤ ਪੇਜ ਦੇਖੋ।
ਆਪਣਾ ਖਾਤਾ ਸੈੱਟ ਕਰਨਾ
- Claude Console ਵਿੱਚ ਸਾਈਨ ਇਨ ਕਰੋ platform.claude.com 'ਤੇ ਅਤੇ ਬਿਲਿੰਗ ਜੋੜੋ।
- API ਕੁੰਜੀ ਬਣਾਓ। ਹਰ ਮਾਹੌਲ (ਟੈਸਟਿੰਗ ਅਤੇ ਪ੍ਰੋਡਕਸ਼ਨ) ਲਈ ਇੱਕ ਕੁੰਜੀ ਰੱਖੋ, ਤਾਂ ਜੋ ਇੱਕ ਨੂੰ ਰੱਦ ਕਰਨ ਨਾਲ ਦੂਜੀ ਨਾ ਟੁੱਟੇ।
- ਖਰਚ ਸੀਮਾ ਸੈੱਟ ਕਰੋ। Anthropic ਦਾ ਗਲਤੀ ਪੇਜ ਦੱਸਦਾ ਹੈ ਕਿ ਜਦੋਂ ਵਰਤੋਂ ਤੁਹਾਡੀ ਸੈੱਟ ਕੀਤੀ ਖਰਚ ਸੀਮਾ ਤੱਕ ਪਹੁੰਚਦੀ ਹੈ, ਤਾਂ API 400 ਗਲਤੀ ਦਿੰਦਾ ਹੈ, ਇਸ ਲਈ ਤੁਹਾਡੀ ਐਪ ਨੂੰ ਉਦੋਂ ਸਾਫ਼ ਸੁਨੇਹਾ ਦਿਖਾਉਣਾ ਚਾਹੀਦਾ ਹੈ।
- ਰੇਟ ਲਿਮਿਟ ਵੇਖੋ ਆਪਣੇ ਖਾਤੇ ਲਈ Console ਵਿੱਚ; ਇਹ ਹਰ ਸੰਸਥਾ ਲਈ ਮਾਪੀ ਜਾਂਦੀ ਹੈ।
ਬੇਨਤੀ ਦਾ ਪ੍ਰਵਾਹ
- ਵਰਤੋਂਕਾਰ ਤੁਹਾਡੀ ਐਪ ਵਿੱਚ ਕੁਝ ਕਰਦਾ ਹੈ: ਸੁਨੇਹਾ ਭੇਜਦਾ ਹੈ, "Summarise" 'ਤੇ ਕਲਿੱਕ ਕਰਦਾ ਹੈ।
- ਬ੍ਰਾਊਜ਼ਰ ਤੁਹਾਡੇ ਸਰਵਰ ਰੂਟ ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ, ਕਦੇ ਵੀ Anthropic ਨੂੰ ਸਿੱਧਾ ਨਹੀਂ।
- ਤੁਹਾਡਾ ਸਰਵਰ ਜਾਂਚਦਾ ਹੈ ਕਿ ਵਰਤੋਂਕਾਰ ਲੌਗਇਨ ਹੈ ਅਤੇ ਇਹ ਫੀਚਰ ਵਰਤਣ ਦੀ ਇਜਾਜ਼ਤ ਰੱਖਦਾ ਹੈ, ਅਤੇ ਪ੍ਰਤੀ-ਵਰਤੋਂਕਾਰ ਸੀਮਾ ਲਾਗੂ ਕਰਦਾ ਹੈ।
- ਇਹ ਬੇਨਤੀ ਬਣਾਉਂਦਾ ਹੈ: ਤੁਹਾਡੇ ਨਿਯਮਾਂ ਵਾਲਾ ਸਿਸਟਮ ਪ੍ਰੋਂਪਟ, ਵਰਤੋਂਕਾਰ ਦਾ ਇਨਪੁੱਟ, ਅਤੇ ਕੰਮ ਲਈ ਲੋੜੀਂਦਾ ਕੋਈ ਵੀ ਡੇਟਾ ਤੁਹਾਡੇ ਡੇਟਾਬੇਸ ਤੋਂ।
- ਇਹ ਵਾਤਾਵਰਣ ਤੋਂ ਕੁੰਜੀ ਅਤੇ ਇੱਕ ਸਮਝਦਾਰ
max_tokensਨਾਲ Messages API ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ। - ਇਹ ਜਵਾਬ ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਨੂੰ ਸਟ੍ਰੀਮ ਕਰਦਾ ਹੈ ਅਤੇ ਜਵਾਬ ਤੋਂ ਟੋਕਨ ਵਰਤੋਂ ਲੌਗ ਕਰਦਾ ਹੈ।
ਵਿਕਲਪ ਅਤੇ ਸਮਝੌਤੇ
| ਫੈਸਲਾ | ਸਧਾਰਨ ਚੋਣ | ਕਦੋਂ ਹੋਰ ਅੱਗੇ ਜਾਣਾ |
|---|---|---|
| ਸਟ੍ਰੀਮਿੰਗ | ਪੂਰੇ ਜਵਾਬ ਦੀ ਉਡੀਕ | ਚੈਟ ਅਤੇ ਕਿਸੇ ਵੀ ਲੰਮੇ ਕੰਮ ਲਈ ਸਟ੍ਰੀਮ ਕਰੋ; Anthropic ਲੰਮੀਆਂ ਬੇਨਤੀਆਂ ਲਈ ਸਟ੍ਰੀਮਿੰਗ ਜਾਂ ਬੈਚ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕਰਦਾ ਹੈ |
| ਆਉਟਪੁੱਟ ਫਾਰਮੈਟ | ਸਾਦਾ ਟੈਕਸਟ | ਜਦੋਂ ਤੁਹਾਡੇ ਕੋਡ ਨੂੰ ਫੀਲਡ ਪੜ੍ਹਨੇ ਹੋਣ ਤਾਂ ਸਟ੍ਰਕਚਰਡ JSON ਆਉਟਪੁੱਟ |
| ਤੁਹਾਡਾ ਡੇਟਾ | ਸੰਬੰਧਿਤ ਰਿਕਾਰਡ ਸ਼ਾਮਲ ਕਰੋ | ਜਦੋਂ ਬਹੁਤ ਜ਼ਿਆਦਾ ਹੋਵੇ ਤਾਂ ਤੁਹਾਡੀ ਸਮੱਗਰੀ 'ਤੇ ਰੀਟਰੀਵਲ (RAG ਕੀ ਹੈ) |
| ਕਾਰਵਾਈਆਂ | ਮਾਡਲ ਸਿਰਫ਼ ਟੈਕਸਟ ਲਿਖਦਾ ਹੈ | Tool use, ਜਿੱਥੇ ਮਾਡਲ ਤੁਹਾਡੇ ਕੋਡ ਨੂੰ ਤੁਹਾਡੇ ਪਰਿਭਾਸ਼ਿਤ ਫੰਕਸ਼ਨ ਚਲਾਉਣ ਲਈ ਕਹਿੰਦਾ ਹੈ |
| ਵੱਡਾ, ਜ਼ਰੂਰੀ ਨਾ ਹੋਣ ਵਾਲਾ ਕੰਮ | ਆਈਟਮਾਂ 'ਤੇ ਲੂਪ | Message Batches API, ਜਿਸ ਨੂੰ ਤੁਸੀਂ ਜਮ੍ਹਾਂ ਕਰਕੇ ਨਤੀਜੇ ਲਈ ਪੋਲ ਕਰਦੇ ਹੋ |
ਆਪਣੇ AI ਬਿਲਡਰ ਨੂੰ ਦੇਣ ਵਾਲੇ ਪ੍ਰੋਂਪਟ
ਪਹਿਲਾ ਫੀਚਰ:
"Ask about this document" ਪੈਨਲ ਜੋੜੋ। ਇਹ ਇੱਕ ਸਰਵਰ ਰੂਟ POST /api/ask ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ ਜੋ ਜਾਂਚਦਾ ਹੈ ਕਿ ਵਰਤੋਂਕਾਰ ਲੌਗਇਨ ਹੈ ਅਤੇ ਦਸਤਾਵੇਜ਼ ਦਾ ਮਾਲਕ ਹੈ, ਫਿਰ ਅਧਿਕਾਰਤ Anthropic SDK ਅਤੇ ਸੀਕ੍ਰੇਟ ANTHROPIC_API_KEY ਨਾਲ Claude Messages API ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ। ਮਾਡਲ ID ਸੀਕ੍ਰੇਟ CLAUDE_MODEL ਤੋਂ ਪੜ੍ਹੋ। ਸਿਸਟਮ ਪ੍ਰੋਂਪਟ: "ਸਿਰਫ਼ ਦਿੱਤੇ ਦਸਤਾਵੇਜ਼ ਤੋਂ ਜਵਾਬ ਦਿਓ। ਜੇ ਜਵਾਬ ਇਸ ਵਿੱਚ ਨਾ ਹੋਵੇ, ਤਾਂ ਇਹ ਕਹੋ।" ਦਸਤਾਵੇਜ਼ ਦਾ ਟੈਕਸਟ ਅਤੇ ਸਵਾਲ ਭੇਜੋ, max_tokens 800 ਸੈੱਟ ਕਰੋ, ਜਵਾਬ ਪੇਜ 'ਤੇ ਸਟ੍ਰੀਮ ਕਰੋ, ਅਤੇ ਕੁੰਜੀ ਨੂੰ ਕਦੇ ਵੀ ਬ੍ਰਾਊਜ਼ਰ ਨੂੰ ਨਾ ਦਿਓ।
ਸੁਰੱਖਿਆ ਬੰਦਿਸ਼ਾਂ ਅਤੇ ਗਲਤੀਆਂ:
ਹਰ ਵਰਤੋਂਕਾਰ ਨੂੰ ਪ੍ਰਤੀ ਘੰਟਾ 20 ਸਵਾਲਾਂ ਤੱਕ ਸੀਮਿਤ ਕਰੋ, ਡੇਟਾਬੇਸ ਵਿੱਚ ਟ੍ਰੈਕ ਕਰਕੇ। ਹਰ ਜਵਾਬ ਤੋਂ ਇਨਪੁੱਟ ਅਤੇ ਆਉਟਪੁੱਟ ਟੋਕਨ ਵਰਤੋਂਕਾਰ ID ਅਤੇ ਬੇਨਤੀ ID ਨਾਲ ਲੌਗ ਕਰੋ। 429 ਜਾਂ 529 ਗਲਤੀਆਂ 'ਤੇ, retry-after ਹੈਡਰ ਦਾ ਆਦਰ ਕਰਦੇ ਹੋਏ, ਐਕਸਪੋਨੈਂਸ਼ੀਅਲ ਬੈਕਆਫ ਨਾਲ 3 ਵਾਰ ਤੱਕ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ, ਫਿਰ "The assistant is busy, try again shortly." ਦਿਖਾਓ। ਜੇ API ਖਰਚ ਸੀਮਾ ਦੀ ਗਲਤੀ ਦੱਸੇ, ਤਾਂ "AI features are paused" ਦਿਖਾਓ ਅਤੇ ਐਡਮਿਨ ਨੂੰ ਸੂਚਿਤ ਕਰੋ।
ਜਿਨ੍ਹਾਂ ਗਲਤੀਆਂ ਲਈ ਤਿਆਰੀ ਕਰਨੀ ਹੈ
Anthropic ਦੇ ਗਲਤੀ ਦਸਤਾਵੇਜ਼ਾਂ ਤੋਂ, ਉਹ ਜੋ ਤੁਹਾਡੀ ਐਪ ਅਸਲ ਵਿੱਚ ਵੇਖੇਗੀ:
| ਕੋਡ | ਕਿਸਮ | ਕੀ ਕਰਨਾ ਹੈ |
|---|---|---|
| 400 | invalid_request_error | ਬੇਨਤੀ ਠੀਕ ਕਰੋ; ਇਹ ਉਦੋਂ ਵੀ ਆਉਂਦਾ ਹੈ ਜਦੋਂ ਤੁਸੀਂ ਸੈੱਟ ਕੀਤੀ ਖਰਚ ਸੀਮਾ ਤੱਕ ਪਹੁੰਚਦੇ ਹੋ |
| 401 | authentication_error | ਜਾਂਚੋ ਕਿ ਕੁੰਜੀ ਮੌਜੂਦ, ਸਹੀ ਅਤੇ ਰੱਦ ਨਾ ਹੋਈ ਹੋਵੇ |
| 413 | request_too_large | ਘੱਟ ਭੇਜੋ; Messages API ਪ੍ਰਤੀ ਬੇਨਤੀ 32 MB ਤੱਕ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ |
| 429 | rate_limit_error | ਰੁਕੋ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ, retry-after ਦਾ ਆਦਰ ਕਰਦੇ ਹੋਏ |
| 500 | api_error | ਬੈਕਆਫ ਨਾਲ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ; ਜੇ ਜਾਰੀ ਰਹੇ ਤਾਂ ਬੇਨਤੀ ID ਨਾਲ ਸਪੋਰਟ ਨਾਲ ਸੰਪਰਕ ਕਰੋ |
| 529 | overloaded_error | ਸਾਰੇ ਵਰਤੋਂਕਾਰਾਂ 'ਤੇ ਅਸਥਾਈ ਉੱਚ ਟ੍ਰੈਫਿਕ; ਰੁਕੋ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ |
Anthropic ਦੇ ਦਸਤਾਵੇਜ਼ ਕਹਿੰਦੇ ਹਨ ਕਿ ਅਧਿਕਾਰਤ SDK ਅਸਥਾਈ ਅਸਫਲਤਾਵਾਂ (ਕਨੈਕਸ਼ਨ ਗਲਤੀਆਂ, ਰੇਟ ਲਿਮਿਟ ਅਤੇ 5xx ਗਲਤੀਆਂ) ਨੂੰ ਡਿਫੌਲਟ ਤੌਰ 'ਤੇ ਐਕਸਪੋਨੈਂਸ਼ੀਅਲ ਬੈਕਆਫ ਨਾਲ ਆਪਣੇ-ਆਪ ਦੋ ਵਾਰ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਨ, ਅਤੇ ਤੁਸੀਂ ਇਹ ਸੰਰਚਿਤ ਕਰ ਸਕਦੇ ਹੋ। ਹਰ ਜਵਾਬ ਵਿੱਚ request-id ਹੈਡਰ ਹੁੰਦਾ ਹੈ; ਇਸਨੂੰ ਲੌਗ ਕਰੋ ਤਾਂ ਕਿ ਸਪੋਰਟ ਸਮੱਸਿਆਵਾਂ ਦਾ ਪਤਾ ਲਗਾ ਸਕੇ।
ਆਮ ਗਲਤੀਆਂ
- ਬ੍ਰਾਊਜ਼ਰ ਤੋਂ API ਕਾਲ ਕਰਨਾ। ਤੁਹਾਡੀ ਕੁੰਜੀ ਜਨਤਕ ਹੋ ਜਾਂਦੀ ਹੈ। ਹਮੇਸ਼ਾ ਆਪਣੇ ਸਰਵਰ ਰਾਹੀਂ ਜਾਓ। ਦੇਖੋ API ਕੁੰਜੀਆਂ ਸੁਰੱਖਿਅਤ ਕਿਵੇਂ ਰੱਖੀਏ।
- ਭੁੱਲਣਾ ਕਿ
max_tokensਇੱਕ ਸੀਮਾ ਹੈ, ਟੀਚਾ ਨਹੀਂ। ਇਸਨੂੰ ਉਤਨਾ ਸੈੱਟ ਕਰੋ ਜਿੰਨਾ ਫੀਚਰ ਨੂੰ ਚਾਹੀਦਾ ਹੈ; ਬਹੁਤ ਘੱਟ ਜਵਾਬ ਕੱਟਦਾ ਹੈ, ਬਹੁਤ ਵੱਧ ਲੰਮੇ ਅਤੇ ਮਹਿੰਗੇ ਜਵਾਬਾਂ ਦਾ ਖਤਰਾ ਹੈ। - ਨਿਯਮ ਯੂਜ਼ਰ ਸੁਨੇਹੇ ਵਿੱਚ ਪਾਉਣਾ। ਸਥਿਰ ਹਦਾਇਤਾਂ
systemਪ੍ਰੋਂਪਟ ਵਿੱਚ ਜਾਂਦੀਆਂ ਹਨ; ਇਜਾਜ਼ਤਾਂ ਤੁਹਾਡੇ ਕੋਡ ਵਿੱਚ ਹੁੰਦੀਆਂ ਹਨ। - ਪੂਰੀ ਚੈਟ ਹਮੇਸ਼ਾ ਭੇਜਣਾ। ਗੱਲਬਾਤ ਵਧਣ 'ਤੇ ਪੁਰਾਣੀਆਂ ਵਾਰੀਆਂ ਛੋਟੀਆਂ ਕਰੋ ਜਾਂ ਸਾਰ ਕੱਢੋ।
- ਕੋਈ ਖਰਚ ਸੀਮਾ ਜਾਂ ਪ੍ਰਤੀ-ਵਰਤੋਂਕਾਰ ਸੀਮਾ ਨਾ ਹੋਣਾ।
- ਮਾਡਲ ID ਸਖ਼ਤ-ਕੋਡ ਕਰਨਾ। ਮਾਡਲ ਅੱਪਡੇਟ ਅਤੇ ਬੰਦ ਹੁੰਦੇ ਰਹਿੰਦੇ ਹਨ।
- ਸਟਾਪ ਕਾਰਨ ਨੂੰ ਨਜ਼ਰਅੰਦਾਜ਼ ਕਰਨਾ। ਜੇ ਜਵਾਬ
max_tokensਤੱਕ ਪਹੁੰਚਣ ਕਰਕੇ ਰੁਕਿਆ, ਤਾਂ ਵਰਤੋਂਕਾਰ ਨੂੰ ਦੱਸੋ ਜਾਂ ਸੀਮਾ ਵਧਾਓ।
ਚੈੱਕਲਿਸਟ
- Claude Console ਵਿੱਚ API ਕੁੰਜੀ ਬਣਾਈ ਅਤੇ ਸਰਵਰ-ਸਾਈਡ ਸੀਕ੍ਰੇਟ ਵਜੋਂ ਸੰਭਾਲੀ
- ਟੈਸਟਿੰਗ ਅਤੇ ਪ੍ਰੋਡਕਸ਼ਨ ਲਈ ਵੱਖਰੀਆਂ ਕੁੰਜੀਆਂ
- ਖਰਚ ਸੀਮਾ ਸੈੱਟ; ਪਹੁੰਚਣ 'ਤੇ ਸਾਫ਼ ਸੁਨੇਹਾ
- ਸਾਰੀਆਂ ਬੇਨਤੀਆਂ ਤੁਹਾਡੇ ਸਰਵਰ ਰਾਹੀਂ, ਇਜਾਜ਼ਤ ਜਾਂਚ ਨਾਲ
- ਸਿਸਟਮ ਪ੍ਰੋਂਪਟ ਵਿੱਚ ਨਿਯਮ; ਮਾਡਲ ID ਕੌਂਫਿਗਰ ਕਰਨ ਯੋਗ
- ਹਰ ਫੀਚਰ ਲਈ
max_tokensਸੈੱਟ; ਲੰਮੇ ਜਵਾਬ ਸਟ੍ਰੀਮ ਕੀਤੇ - ਤੁਹਾਡੀ ਐਪ ਵਿੱਚ ਪ੍ਰਤੀ-ਵਰਤੋਂਕਾਰ ਰੇਟ ਲਿਮਿਟ
- 429 ਅਤੇ 529 ਬੈਕਆਫ ਨਾਲ ਸੰਭਾਲੇ; ਬੇਨਤੀ ID ਲੌਗ ਕੀਤੇ
- ਦੋਸਤਾਨਾ ਗਲਤੀ ਸਥਿਤੀ ਜੋ ਪੇਜ ਨੂੰ ਨਹੀਂ ਤੋੜਦੀ
- ਖਾਲੀ, ਬਹੁਤ ਲੰਮੇ ਅਤੇ ਖਤਰਨਾਕ ਇਨਪੁੱਟਾਂ ਨਾਲ ਟੈਸਟ ਕੀਤਾ
Mythex ਵਿੱਚ Claude API ਵਰਤਣਾ
Mythex 'ਤੇ ਬਣਾਈਆਂ ਐਪਾਂ ਵਿੱਚ, Claude ਫੀਚਰ ਤੁਹਾਡੀ ਆਪਣੀ Anthropic ਕੁੰਜੀ ਵਰਤਦੇ ਹਨ ਅਤੇ ਬਿਲ ਤੁਹਾਡੇ Anthropic ਖਾਤੇ ਨੂੰ ਜਾਂਦਾ ਹੈ, Mythex ਬਿਲਡ ਕ੍ਰੈਡਿਟਸ ਨੂੰ ਨਹੀਂ। ਇਹ ਉਸ Mythex ਏਜੰਟ ਤੋਂ ਵੱਖਰਾ ਹੈ ਜੋ ਤੁਹਾਡਾ ਕੋਡ ਲਿਖਦਾ ਹੈ। ANTHROPIC_API_KEY ਨੂੰ /secrets, ਪ੍ਰੋਜੈਕਟ ਸੈਟਿੰਗਾਂ ਜਾਂ ਚੈਟ ਵਿੱਚ ਸੀਕ੍ਰੇਟ ਕਾਰਡ ਰਾਹੀਂ ਪ੍ਰੋਜੈਕਟ ਸੀਕ੍ਰੇਟ ਵਜੋਂ ਜੋੜੋ, ਫਿਰ ਉੱਪਰ ਵਾਂਗ ਪ੍ਰੋਂਪਟ ਵਰਤ ਕੇ ਫੀਚਰ ਦਾ ਵੇਰਵਾ ਦਿਓ। ਲਾਈਵ ਐਪ 'ਤੇ ਸੀਕ੍ਰੇਟ ਬਦਲਣ ਤੋਂ ਬਾਅਦ ਦੁਬਾਰਾ ਪ੍ਰਕਾਸ਼ਿਤ ਕਰੋ। ਸ਼ੁਰੂਆਤੀ ਪ੍ਰੋਂਪਟ ਲਈ Add AI features with your own API keys ਦੇਖੋ। ਜੇ ਤੁਸੀਂ ਪ੍ਰਦਾਤਾਵਾਂ ਵਿਚਕਾਰ ਚੋਣ ਕਰ ਰਹੇ ਹੋ, ਤਾਂ OpenAI API ਕਿਵੇਂ ਜੋੜੀਏ OpenAI ਲਈ ਉਹੀ ਗੱਲਾਂ ਕਵਰ ਕਰਦਾ ਹੈ।
ਸਵਾਲ
Claude API ਕੁੰਜੀ ਕਿਵੇਂ ਲਈਏ?
platform.claude.com 'ਤੇ Claude Console ਵਿੱਚ ਸਾਈਨ ਇਨ ਕਰੋ, ਬਿਲਿੰਗ ਸੈੱਟ ਕਰੋ, ਅਤੇ API ਕੁੰਜੀ ਬਣਾਓ। ਇਸਨੂੰ ਸਰਵਰ-ਸਾਈਡ ਸੀਕ੍ਰੇਟ ਵਜੋਂ ਸੰਭਾਲੋ, ਜੋ ਆਮ ਤੌਰ 'ਤੇ ANTHROPIC_API_KEY ਨਾਂ ਨਾਲ ਹੁੰਦਾ ਹੈ, ਅਤੇ ਇਸਨੂੰ ਕਦੇ ਵੀ ਬ੍ਰਾਊਜ਼ਰ ਕੋਡ ਵਿੱਚ ਨਾ ਪਾਓ।
Claude API ਲਈ ਬੇਨਤੀ ਨੂੰ ਕੀ ਚਾਹੀਦਾ ਹੈ?
ਸਤੰਬਰ 2026 ਤੱਕ, Anthropic ਦਾ Messages API ਹਵਾਲਾ ਤਿੰਨ ਲੋੜੀਂਦੇ ਬਾਡੀ ਫੀਲਡ ਦਿਖਾਉਂਦਾ ਹੈ: model, max_tokens ਅਤੇ messages। ਸਿੱਧੀਆਂ HTTP ਕਾਲਾਂ ਨੂੰ x-api-key ਅਤੇ anthropic-version ਹੈਡਰ ਵੀ ਚਾਹੀਦੇ ਹਨ; ਅਧਿਕਾਰਤ SDK ਇਹ ਤੁਹਾਡੇ ਲਈ ਸੈੱਟ ਕਰਦੇ ਹਨ।
Claude API ਤੋਂ 529 ਗਲਤੀ ਕੀ ਹੁੰਦੀ ਹੈ?
Anthropic ਦਾ ਗਲਤੀ ਪੇਜ 529 ਨੂੰ overloaded_error ਦੱਸਦਾ ਹੈ: ਸਾਰੇ ਵਰਤੋਂਕਾਰਾਂ ਵਿੱਚ ਉੱਚ ਟ੍ਰੈਫਿਕ ਕਾਰਨ API ਕੁਝ ਸਮੇਂ ਲਈ ਓਵਰਲੋਡ ਹੈ। ਐਕਸਪੋਨੈਂਸ਼ੀਅਲ ਬੈਕਆਫ ਨਾਲ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ। ਅਧਿਕਾਰਤ SDK ਕੁਝ ਅਸਥਾਈ ਗਲਤੀਆਂ ਲਈ ਆਪਣੇ-ਆਪ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਨ।
ਕੀ ਮੈਂ OpenAI SDK ਲਈ ਲਿਖੇ ਕੋਡ ਨਾਲ Claude ਵਰਤ ਸਕਦਾ ਹਾਂ?
Anthropic OpenAI SDK ਅਨੁਕੂਲਤਾ ਪਰਤ ਦਾ ਦਸਤਾਵੇਜ਼ ਦਿੰਦਾ ਹੈ, ਜਿਸ ਨਾਲ OpenAI SDK ਰਾਹੀਂ Claude ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ। ਨਵੇਂ ਕੋਡ ਲਈ, ਇਸਦੇ ਆਪਣੇ SDK Claude ਦੀਆਂ ਖਾਸ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਤੱਕ ਪਹੁੰਚ ਦਿੰਦੇ ਹਨ, ਇਸ ਲਈ ਆਮ ਤੌਰ 'ਤੇ ਇਹ ਬਿਹਤਰ ਸ਼ੁਰੂਆਤ ਹੈ।