# Chat Create

## POST /async/chat/create

> Queue a new asynchronous chat completion task for background processing and later retrieval.

```json
{"openapi":"3.0.3","info":{"title":"Distribute.AI API","version":"1.0.0"},"tags":[{"name":"async.chat","description":"Asynchronous task queuing operations."}],"servers":[{"url":"https://api.distribute.ai"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"authorization"}}},"paths":{"/async/chat/create":{"post":{"operationId":"asyncChatCreate","tags":["async.chat"],"description":"Queue a new asynchronous chat completion task for background processing and later retrieval.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"role":{"type":"string","enum":["system"]},"content":{"type":"string"},"name":{"type":"string"}},"required":["role","content"],"additionalProperties":false},{"type":"object","properties":{"role":{"type":"string","enum":["user"]},"content":{"type":"string"},"name":{"type":"string"}},"required":["role","content"],"additionalProperties":false},{"type":"object","properties":{"role":{"type":"string","enum":["assistant"]},"content":{"type":"string"},"name":{"type":"string"},"tool_calls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["function"]},"function":{"type":"object","properties":{"arguments":{"type":"object","additionalProperties":{"type":"string"}},"name":{"type":"string"}},"required":["arguments","name"],"additionalProperties":false}},"required":["id","type","function"],"additionalProperties":false}}},"required":["role","tool_calls"],"additionalProperties":false},{"type":"object","properties":{"role":{"type":"string","enum":["tool"]},"content":{"type":"string"},"tool_call_id":{"type":"string"}},"required":["role","content","tool_call_id"],"additionalProperties":false}]}},"model":{"type":"string","enum":["Llama-3.1 8B","Llama-3.3 70B"]},"reasoning_effort":{"type":"string","enum":["low","medium","high"],"default":"medium"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"frequency_penalty":{"type":"number","minimum":-2,"maximum":2,"default":0},"max_completion_tokens":{"type":"number","minimum":-1,"maximum":600,"default":128},"n":{"type":"number","enum":[1],"default":1},"modalities":{"type":"array","items":{"type":"string","enum":["text"]},"default":["text"]},"presence_penalty":{"type":"number","minimum":-2,"maximum":2,"default":0},"seed":{"type":"number","default":591256},"service_tier":{"type":"string","enum":["auto","default"],"default":"default"},"stop":{"type":"array","items":{"type":"string"}},"stream":{"type":"boolean","default":false},"stream_options":{"type":"object","properties":{"include_usage":{"type":"boolean"}},"additionalProperties":false},"temperature":{"type":"number","minimum":0,"maximum":2,"default":1},"top_p":{"type":"number","minimum":0,"maximum":1,"default":1},"tools":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["function"]},"function":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string","maxLength":64},"parameters":{"type":"object","additionalProperties":{"type":"string"}},"strict":{"type":"boolean","default":false}},"required":["name"],"additionalProperties":false}},"required":["type","function"],"additionalProperties":false}},"tool_choice":{"anyOf":[{"type":"string","enum":["none","auto","required"]},{"type":"object","properties":{"type":{"type":"string","enum":["function"]},"function":{"type":"object","properties":{"name":{"type":"string","maxLength":64}},"required":["name"],"additionalProperties":false}},"required":["type","function"],"additionalProperties":false}]},"parallel_tool_calls":{"type":"boolean","default":true}},"required":["messages","model"],"additionalProperties":false}}},"required":true},"responses":{"200":{"description":"Returns a unique ID for the asynchronous chat task, used to retrieve the generated result once processing is complete.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false,"description":"Returns a unique ID for the asynchronous chat task, used to retrieve the generated result once processing is complete."}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}}}}}}}
```