Developers
Bring the assistant to your app, your MCP client or your website. Every door costs the same as the chat app.
POST/api/v1/conversations
Start a conversation: { text, locale?, model?, tools? } — use tools to create images, video, music or speech.
tools
Real request: the message cost is charged to your credits. (1 credit)
Code
curl -X POST "https://bilgisam.com/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"en"}'Response body
The response will appear here.
Documentation
Multimedia
The chat app’s tools are in the API too: image, video, music, text-to-speech and web search. Add them with the tools field; generated files come back in the response’s media array with public URLs.
curl -X POST https://bilgisam.com/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "a red fox in the snow, watercolor", "tools": ["generate_image"]}'
# GET /api/v1/conversations/{id}
{
"pending": false,
"generating": false,
"messages": [
{ "role": "assistant", "content": "…", "media": [
{ "name": "image.png", "type": "image/png", "url": "https://…/image.png" }
] }
]
}
# edit_image: upload the source, then attach it
curl -X POST https://bilgisam.com/api/v1/files -H "Authorization: Bearer sk_..." -F "file=@photo.jpg"
# → {"id": "…", "image": "https://…"}
curl -X POST https://bilgisam.com/api/v1/conversations -H "Authorization: Bearer sk_..." -H "Content-Type: application/json" -d '{"text": "make the background a sunset beach", "tools": ["edit_image"], "files": ["<file id>"]}'