Quickstart

Create a key, queue a turn, and poll until the run finishes.

Set BASE to the API origin. Production is https://magica-backend-oda9.onrender.com. Keys are created while you are signed in. Public calls use the key, not the session.

export BASE=https://magica-backend-oda9.onrender.com

1. Create an API key

   In the product, open API / MCP and create a key. Or, with a signed-in session:

   curl -X POST "$BASE/api/keys" \
     -H "Authorization: Bearer $CLERK_SESSION_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"name":"local"}'
   

   Store the key field. Later list calls only return prefix.

2. Send a message

   You do not create a chat first. Omit chatId and the API creates one. Attach a file with multipart, or pass image_urls if you already have a URL.

   curl -X POST "$BASE/api/v1/completions" \
     -H "Authorization: Bearer $GALAXY_API_KEY" \
     -F "text=What is in this photo?" \
     -F "file=@./photo.jpg;type=image/jpeg"
   

   Response 202:

   {
     "chatId": "…",
     "messageId": "…",
     "runId": "…",
     "triggerRunId": "…",
     "status": "queued"
   }
   
3. Poll the run

   curl "$BASE/api/v1/chats/$CHAT_ID/runs/$RUN_ID" \
     -H "Authorization: Bearer $GALAXY_API_KEY"
   

   Stop when status is COMPLETE, FAILED, or CANCELLED. Read assistant.contentBlocks for the reply and errorMessage if it failed.

Send into an existing chat

POST /completions with chatId, text, and file in one multipart request.

Call a Magica tool

Crop, generate, or merge without waiting on the agent loop.