curl Examples
Quick curl command examples for testing the B4M Completions API from the command line.
Prerequisites
Set your API key as an environment variable:
export B4M_API_KEY="b4m_live_xxxxxxxxxxxx"
Always use --no-buffer flag to see streaming output in real-time.
Basic Request
Simple completion request:
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-w "\nHTTP %{http_code}\n" \
-d '{
"model": "claude-sonnet-5",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
-w prints the HTTP status after the stream. A failure before the stream opens shows a JSON error body and a non-200 status; a failure after it opens still shows HTTP 200, with an error event in the stream.
Expected output:
data: {"type":"content","text":"Hello! How can I help you today?","usage":{"inputTokens":10,"outputTokens":9}}
data: [DONE]
HTTP 200
With Options
Request with temperature and max_tokens:
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [
{"role": "user", "content": "Write a short poem"}
],
"temperature": 0.8,
"max_tokens": 200
}'
Multi-turn Conversation
Request with conversation history:
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [
{"role": "user", "content": "What is the capital of France?"},
{"role": "assistant", "content": "The capital of France is Paris."},
{"role": "user", "content": "What is its population?"}
]
}'
With System Message
Request with system instructions:
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [
{
"role": "system",
"content": "You are a helpful assistant that explains things in simple terms."
},
{
"role": "user",
"content": "Explain quantum computing"
}
]
}'
With Tools
Request with tool definitions:
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [
{"role": "user", "content": "What is the weather in London?"}
],
"options": {
"tools": [
{
"toolSchema": {
"name": "get_weather",
"description": "Get weather for a location",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "City name"
}
},
"required": ["location"]
}
}
}
]
}
}'
Alternative Authentication Headers
Using Authorization: ApiKey
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: ApiKey $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Using Authorization: Bearer
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Debugging with Verbose Output
Show full HTTP request and response headers:
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-v \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Verbose output includes:
- Request headers
- Response headers (including rate limits)
- HTTP status code
- SSL/TLS information
Filtering Output
Show only data lines
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Count to 5"}]
}' | grep "^data:"
Show only HTTP headers
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-v \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}' 2>&1 | grep -E "^(< |> )"
Pretty-print JSON events with jq
Save this as a script (for example stream.sh) so exit ends it. It exits non-zero on an error event, or when the stream ends without [DONE]:
done_seen=0
while IFS= read -r line; do
[[ $line == data:* ]] || continue
data="${line#data: }"
if [[ $data == "[DONE]" ]]; then done_seen=1; break; fi
echo "$data" | jq .
if [[ $(echo "$data" | jq -r .type) == "error" ]]; then
echo "Stream error" >&2
exit 1
fi
done < <(curl -sS --no-buffer -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}')
if [[ $done_seen -ne 1 ]]; then
echo "Stream ended without [DONE]" >&2
exit 1
fi
Save Output to File
Save complete response to file:
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Write a story"}]
}' > response.txt
Testing Different Models
Call GET /api/v1/models with your API key to list the model ids available to you. Ids depend on which providers the deployment and your own provider keys enable, so if an example returns 400 unknown_model or 503 provider_not_configured, use an id from that list. Change the model field in any example above.
Error Testing
Test with invalid API key
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer b4m_live_invalid" \
-H "Content-Type: application/json" \
--no-buffer \
-w "\nHTTP %{http_code}\n" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Expected: a JSON error body, then HTTP 401 - Unauthorized
Test with invalid model
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-w "\nHTTP %{http_code}\n" \
-d '{
"model": "invalid-model",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Expected: a JSON error body, then HTTP 400 - Bad Request
Test with missing required field
curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-w "\nHTTP %{http_code}\n" \
-d '{
"model": "claude-sonnet-5"
}'
Expected: a JSON error body, then HTTP 422 - Unprocessable Entity (missing messages)
Performance Testing
Measure response time
time curl -X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}' > /dev/null
Measure time to first byte
curl -w "Time to first byte: %{time_starttransfer}s\n" \
-X POST https://app.bike4mind.com/api/ai/v1/completions \
-H "Authorization: Bearer $B4M_API_KEY" \
-H "Content-Type: application/json" \
--no-buffer \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello!"}]
}' > /dev/null
Useful curl Options
| Option | Description | Example |
|---|---|---|
--no-buffer | Disable output buffering (required for streaming) | curl --no-buffer ... |
-v | Verbose output (show headers) | curl -v ... |
-s | Silent mode (hide progress) | curl -s ... |
-o file | Save output to file | curl -o response.txt ... |
-w format | Custom output format | curl -w "%{http_code}\n" ... |
-H header | Add custom header | curl -H "Authorization: Bearer ..." ... |
-d data | Send POST data | curl -d '{"key":"value"}' ... |
-X method | Specify HTTP method | curl -X POST ... |
Common Issues
Problem: No streaming output
Symptom: Entire response appears at once instead of streaming
Solution: Always use --no-buffer flag:
curl --no-buffer ... # Required for streaming
Problem: Binary characters in output
Symptom: Strange characters appear in terminal
Solution: This is normal for SSE. Use grep or jq to filter:
curl ... | grep "^data:" | sed 's/^data: //'
Problem: SSL certificate errors
Symptom: SSL certificate problem
Solution: Use -k to skip certificate verification (development only):
curl -k ... # Skip SSL verification (insecure, dev only)
Next Steps
- JavaScript Examples - Implement in JavaScript
- Python Examples - Implement in Python
- Best Practices - Production patterns
- Streaming Guide - Detailed streaming documentation