Faça sua primeira solicitação à API
Crie uma chave de API ShareAI, escolha um modelo disponível e envie uma solicitação de chat do seu servidor com autenticação Bearer.
Nesta página
Comece aqui quando sua aplicação for fazer solicitações usando uma chave de API do seu próprio espaço de trabalho ShareAI. Você precisa de uma conta ShareAI, uma chave ativa e acesso ao modelo que deseja executar.
1. Criar uma chave de API#
Abrir Console ShareAI e selecione o espaço de trabalho que será proprietário da chave e do uso. Abra Chaves de API, escolha Criar chave de API., dê à chave um nome reconhecível e salve o segredo no ambiente do seu servidor.


2. Escolher um modelo#
Abrir Modelos e copie o identificador exato do modelo mostrado lá. Verifique a disponibilidade atual e as restrições do modelo/provider na sua chave. Um identificador em um tutorial antigo não garante que a capacidade esteja disponível hoje.
3. Enviar a solicitação#
https://api.shareai.now/api/v1/chat/completionsGere uma resposta usando um modelo disponível.
- URL Base
https://api.shareai.now- Autenticação
- Chave API Bearer
Substituir MODEL_IDENTIFIER com o identificador selecionado. Configure SHAREAI_API_KEY no seu ambiente antes de executar o exemplo.
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'MODEL_IDENTIFIER', 'messages': [{'role': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
4. Ler o resultado#
Para uma solicitação bem-sucedida sem streaming, verifique se done é true e leia a mensagem do assistente de message.content. Verifique tanto o status HTTP quanto qualquer objeto de erro no corpo antes de tratá-lo como uma conclusão bem-sucedida. Um resultado sem dispositivo pode atualmente chegar como um objeto de erro com HTTP 200.
Se a solicitação falhar#
| Status | Próximo passo |
|---|---|
| 401 | Verifique a chave, o espaço de trabalho e o cabeçalho Authorization. |
| 402 | Verifique os créditos disponíveis ou o saldo aplicável. |
| 403 | Verifique os modelos e providers permitidos. |
| 429 | Aguarde o Retry-After quando presente, depois tente novamente com um atraso limitado. |
| 503 | Verifique a capacidade atual ou a disponibilidade do serviço; mantenha um limite de tentativas. |
Próximos passos#
Referência de solicitação e resposta de chat explica o corpo suportado. Se cada cliente precisar autorizar sua própria conta, siga OAuth da aplicação.
Última atualização em 15 de setembro de 2026