An API for everyoneUser guide
Website ↗
User guideAPI and formats

Choose an API format

Chat Completions or Responses: which should you choose?

They are two ways to format communication, not two models. Think of describing the same task in chat messages or filling in a task form. Both sides must understand the format.

API formatPlain-language explanationHarness option
OpenAI Chat CompletionsOrganizes the conversation as messages: what you said, which tool the model requested, and what the tool returned.openai-completions
OpenAI ResponsesUses separate types of records for text replies, tool calls, and tool results, so the app can handle each part of a task.openai-responses

OpenAI in the name refers to the interface format. If you select the DeepSeek model in this guide, DeepSeek still answers. Choosing an OpenAI format does not turn it into a GPT model.

Four common questions

Will Responses make the AI smarter?

Changing the format does not upgrade the model. Apps and models may support each format differently, so results depend on the combination. This test did not establish which gives better answers.

Can Chat Completions do more than chat?

Yes. In Harness, we completed a file read, calculation, save, and read-back check. Harness tools perform the actions; the model uses the results to continue.

Do I need Responses to adjust thinking effort?

No. Both formats accepted effort requests for this model. You still need to enable the model’s effort levels in Harness, as shown in step 6. Changing formats does not enable the menu.

Should I choose Chat Completions in every other agent app?

Follow the guide for that app and model. These results apply to the tested Harness and DeepSeek combination, not every tool or model.

Anthropic Messages

Anthropic Messages is a third format commonly used by Claude Code. It is a message format, not a model. That client appends /v1/messages to the root, whereas the OpenAI-compatible examples include /v1 in their base URL. Our Codex guide uses Responses, the Harness example starts with Chat Completions, and Kimi Code follows its configured type. Follow the tool guide and confirm model support; changing format does not add tools or effort levels.

Read next