Quickstart
Complete the basic setup and send your first conversation request in minutes.
Prepare your environment
Make sure your environment has the required tools and server-side credentials.
- An HTTP client that supports HTTPS.
- A project with an API key.
- Optional: an official SDK for your runtime.
Configure authentication
ORYASTRA AI authenticates requests with a bearer token. Never expose an API key in browser code or commit it to source control.
Authorization: Bearer YOUR_API_KEYNote
An API key is shown in full only when it is created. Store it in a secure secrets manager.
Send your first request
Choose a language and run the minimal example below. Your preference is reused by later code samples.
curl https://www.oryastra.com/api/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "oryastra-chat",
"messages": [{"role": "user", "content": "Hello"}]
}'Read the response
A successful request returns JSON. Keep its request identifier for log correlation and troubleshooting.
Response
{
"id": "chatcmpl_01J9...",
"model": "oryastra-chat",
"choices": [
{ "message": { "role": "assistant", "content": "Hello!" } }
]
}Base configuration
- Base URL
- https://www.oryastra.com/api/v1
- Authentication
- Bearer Token
- Data format
- JSON
- Recommended timeout
- 30s