Skip to main content

​
Endpoint

POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions

​
Request Body

interface ChatCompletionRequest {
  // Required
  messages: Array<{
    role: "user" | "assistant" | "system";
    content: string;
  }>;

  // OpenAI compatible
  model?: string;              // Default: "eachsense/beta"
  stream?: boolean;            // Default: true

  // each::labs extensions
  session_id?: string;         // Conversation continuity
  mode?: "max" | "eco";        // Quality mode (default: "max")
  behavior?: "agent" | "plan" | "ask";  // Behavior mode
  image_urls?: string[];       // Image inputs (max 4)
  workflow_id?: string;        // For workflow operations
  version_id?: string;         // Workflow version
  web_search?: boolean;        // Enable web search (default: true)
  enable_safety_checker?: boolean;  // NSFW filter (default: true)
}

​
Parameters

ParameterTypeRequiredDefaultDescription
messagesarrayYes-OpenAI-compatible message array
modelstringNo"eachsense/beta"Model identifier
streambooleanNotrueEnable SSE streaming
session_idstringNo-Session ID for conversation continuity
modestringNo"max"Quality mode: "max" or "eco"
behaviorstringNo"agent""agent", "plan", or "ask"
image_urlsstring[]No-Image URLs for analysis/editing (max 4)
workflow_idstringNo-Target workflow for execution
version_idstringNo-Workflow version
web_searchbooleanNotrueEnable web search capability
enable_safety_checkerbooleanNotrueNSFW content filter

​
Code Examples

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a sunset over mountains"}],
    "stream": true,
    "session_id": "my-session",
    "mode": "max"
  }'

​
Response (Non-Streaming)

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1708345678,
  "model": "eachsense/beta",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here's your generated image of a sunset over mountains!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 25,
    "total_tokens": 40
  },
  "generations": ["https://storage.eachlabs.ai/xxx.png"],
  "task_id": "task_abc123",
  "session_id": "my-session"
}

​
Extended Response Fields

FieldTypeDescription
generationsstring[]URLs of generated media
task_idstringUnique task identifier
session_idstringSession ID for continuity
workflow_idstringCreated/used workflow ID

​
Response (Streaming)

See Streaming for the full SSE streaming format with 18 event types. 
data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","model":"eachsense/beta","choices":[{"index":0,"delta":{"content":"I'll generate..."},"finish_reason":null}],"eachlabs":{"type":"text_response"}}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","model":"eachsense/beta","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"eachlabs":{"type":"generation_response","url":"https://..."}}

data: [DONE]

​
Error Responses

StatusBodyDescription
401{"detail": "API key is required."}Missing API key
401{"detail": "Invalid API key."}Invalid API key
422{"detail": [{"loc": ["body","messages"], "msg": "field required"}]}Missing messages
429{"detail": "Rate limit exceeded."}Rate limited
Last modified on March 6, 2026