> This page is for version v2 API (default). > For other versions, use one of these documentation indexes: > - v2 API (default): https://docs.cohere.com/v2/llms.txt > - v1 API: https://docs.cohere.com/v1/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.cohere.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.cohere.com/_mcp/server. # Chat POST https://api.cohere.com/v2/chat Content-Type: application/json Generates a text response to a user message and streams it down, token by token. To learn how to use the Chat API with streaming follow our [Text Generation guides](https://docs.cohere.com/v2/docs/chat-api). Follow the [Migration Guide](https://docs.cohere.com/v2/docs/migrating-v1-to-v2) for instructions on moving from API v1 to API v2. Reference: https://docs.cohere.com/reference/chat ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Headers - `X-Client-Name` (string, optional) — The name of the project that is making the request. ### Body (application/json) This endpoint expects an object. - `stream` (false, required) — Defaults to `false`. When `true`, the response will be a SSE stream of events. Streaming is beneficial for user interfaces that render the contents of the response piece by piece, as it gets generated. - `model` (string, required) — The name of a compatible [Cohere model](https://docs.cohere.com/v2/docs/models). - `messages` (list of ChatMessageV2, required) — A list of chat messages in chronological order, representing a conversation between the user and the model. Messages can be from `User`, `Assistant`, `Tool` and `System` roles. Learn more about messages and roles in [the Chat API guide](https://docs.cohere.com/v2/docs/chat-api). - `tools` (list of ToolV2, optional) — A list of tools (functions) available to the model. The model response may contain 'tool_calls' to the specified tools. Learn more in the [Tool Use guide](https://docs.cohere.com/docs/tools). - `documents` (list of V2ChatPostRequestBodyContentApplicationJsonSchemaDocumentsItems, optional) — A list of relevant documents that the model can cite to generate a more accurate reply. Each document is either a string or document object with content and metadata. - `citation_options` (CitationOptions, optional) — Options for controlling citation generation. - `response_format` (ResponseFormatV2, optional) — Configuration for forcing the model output to adhere to the specified format. Supported on [Command R](https://docs.cohere.com/v2/docs/command-r), [Command R+](https://docs.cohere.com/v2/docs/command-r-plus) and newer models. The model can be forced into outputting JSON objects by setting `{ "type": "json_object" }`. A [JSON Schema](https://json-schema.org/) can optionally be provided, to ensure a specific structure. **Note**: When using `{ "type": "json_object" }` your `message` should always explicitly instruct the model to generate a JSON (eg: *"Generate a JSON ..."*) . Otherwise the model may end up getting stuck generating an infinite stream of characters and eventually run out of context length. **Note**: When `json_schema` is not specified, the generated object can have up to 5 layers of nesting. **Limitation**: The parameter is not supported when used in combinations with the `documents` or `tools` parameters. - `safety_mode` (enum, optional) — Used to select the [safety instruction](https://docs.cohere.com/v2/docs/safety-modes) inserted into the prompt. Defaults to `CONTEXTUAL`. When `OFF` is specified, the safety instruction will be omitted. Safety modes are not yet configurable in combination with `tools` and `documents` parameters. **Note**: This parameter is only compatible newer Cohere models, starting with [Command R 08-2024](https://docs.cohere.com/docs/command-r#august-2024-release) and [Command R+ 08-2024](https://docs.cohere.com/docs/command-r-plus#august-2024-release). **Note**: `command-r7b-12-2024` and newer models only support `"CONTEXTUAL"` and `"STRICT"` modes. - Allowed values: `CONTEXTUAL`, `STRICT`, `OFF` - `max_tokens` (integer, optional) — The maximum number of output tokens the model will generate in the response. If not set, `max_tokens` defaults to the model's maximum output token limit. You can find the maximum output token limits for each model in the [model documentation](https://docs.cohere.com/docs/models). **Note**: Setting a low value may result in incomplete generations. In such cases, the `finish_reason` field in the response will be set to `"MAX_TOKENS"`. **Note**: If `max_tokens` is set higher than the model's maximum output token limit, the generation will be capped at that model-specific maximum limit. - `stop_sequences` (list of string, optional) — A list of up to 5 strings that the model will use to stop generation. If the model generates a string that matches any of the strings in the list, it will stop generating tokens and return the generated text up to that point not including the stop sequence. - `temperature` (double, optional) — Defaults to `0.3`. A non-negative float that tunes the degree of randomness in generation. Lower temperatures mean less random generations, and higher temperatures mean more random generations. Randomness can be further maximized by increasing the value of the `p` parameter. - `seed` (integer, optional) — If specified, the backend will make a best effort to sample tokens deterministically, such that repeated requests with the same seed and parameters should return the same result. However, determinism cannot be totally guaranteed. - `frequency_penalty` (double, optional) — Defaults to `0.0`, min value of `0.0`, max value of `1.0`. Used to reduce repetitiveness of generated tokens. The higher the value, the stronger a penalty is applied to previously present tokens, proportional to how many times they have already appeared in the prompt or prior generation. - `presence_penalty` (double, optional) — Defaults to `0.0`, min value of `0.0`, max value of `1.0`. Used to reduce repetitiveness of generated tokens. Similar to `frequency_penalty`, except that this penalty is applied equally to all tokens that have already appeared, regardless of their exact frequencies. - `k` (integer, optional, default: 0) — Ensures that only the top `k` most likely tokens are considered for generation at each step. When `k` is set to `0`, k-sampling is disabled. Defaults to `0`, min value of `0`, max value of `500`. - `p` (double, optional, default: 0.75) — Ensures that only the most likely tokens, with total probability mass of `p`, are considered for generation at each step. If both `k` and `p` are enabled, `p` acts after `k`. Defaults to `0.75`. min value of `0.01`, max value of `0.99`. - `logprobs` (boolean, optional) — Defaults to `false`. When set to `true`, the log probabilities of the generated tokens will be included in the response. - `tool_choice` (enum, optional) — Used to control whether or not the model will be forced to use a tool when answering. When `REQUIRED` is specified, the model will be forced to use at least one of the user-defined tools, and the `tools` parameter must be passed in the request. When `NONE` is specified, the model will be forced **not** to use one of the specified tools, and give a direct response. If tool_choice isn't specified, then the model is free to choose whether to use the specified tools or not. **Note**: This parameter is only compatible with models [Command-r7b](https://docs.cohere.com/v2/docs/command-r7b) and newer. - Allowed values: `REQUIRED`, `NONE` - `thinking` (Thinking, optional) — Configuration for [reasoning features](https://docs.cohere.com/docs/reasoning). - `priority` (integer, optional, default: 0) — Controls how early the request is handled. Lower numbers indicate higher priority (default: 0, the highest). When the system is under load, higher-priority requests are processed first and are the least likely to be dropped. - `strict_tools` (boolean, optional) — When set to `true`, tool calls in the Assistant message will be forced to follow the tool definition strictly. Learn more in the [Structured Outputs (Tools) guide](https://docs.cohere.com/docs/structured-outputs-json#structured-outputs-tools). **Note**: The first few requests with a new set of tools will take longer to process. ## Response ### 200 - `id` (string, required) — Unique identifier for the generated reply. Useful for submitting feedback. - `finish_reason` (enum, required) — The reason a chat request has finished. - **complete**: The model finished sending a complete message. - **max_tokens**: The number of generated tokens exceeded the model's context length or the value specified via the `max_tokens` parameter. - **stop_sequence**: One of the provided `stop_sequence` entries was reached in the model's generation. - **tool_call**: The model generated a Tool Call and is expecting a Tool Message in return - **error**: The generation failed due to an internal error - **timeout**: The generation was stopped because it exceeded the allowed time limit. - Allowed values: `COMPLETE`, `STOP_SEQUENCE`, `MAX_TOKENS`, `TOOL_CALL`, `ERROR`, `TIMEOUT` - `message` (AssistantMessageResponse, required) — A message from the assistant role can contain text and tool call information. - `usage` (Usage, optional) - `logprobs` (list of LogprobItem, optional) ## Errors ### 400 Bad Request Error This error is returned when the request is not well formed. This could be because: - JSON is invalid - The request is missing required fields - The request contains an invalid combination of fields - `message` (string, optional) - `id` (string, optional) ### 401 Unauthorized Error This error indicates that the operation attempted to be performed is not allowed. This could be because: - The api token is invalid - The user does not have the necessary permissions - `message` (string, optional) - `id` (string, optional) ### 403 Forbidden Error This error indicates that the operation attempted to be performed is not allowed. This could be because: - The api token is invalid - The user does not have the necessary permissions - `message` (string, optional) - `id` (string, optional) ### 404 Not Found Error This error is returned when a resource is not found. This could be because: - The endpoint does not exist - The resource does not exist eg model id, dataset id - `message` (string, optional) - `id` (string, optional) ### 422 Unprocessable Entity Error This error is returned when the request is not well formed. This could be because: - JSON is invalid - The request is missing required fields - The request contains an invalid combination of fields - `message` (string, optional) - `id` (string, optional) ### 429 Too Many Requests Error Too many requests - `message` (string, optional) - `id` (string, optional) ### 498 Invalid Token Error This error is returned when a request or response contains a deny-listed token. - `message` (string, optional) - `id` (string, optional) ### 499 Client Closed Request Error This error is returned when a request is cancelled by the user. - `message` (string, optional) - `id` (string, optional) ### 500 Internal Server Error This error is returned when an uncategorised internal server error occurs. - `message` (string, optional) - `id` (string, optional) ### 501 Not Implemented Error This error is returned when the requested feature is not implemented. - `message` (string, optional) - `id` (string, optional) ### 503 Service Unavailable Error This error is returned when the service is unavailable. This could be due to: - Too many users trying to access the service at the same time - `message` (string, optional) - `id` (string, optional) ### 504 Gateway Timeout Error This error is returned when a request to the server times out. This could be due to: - An internal services taking too long to respond - `message` (string, optional) - `id` (string, optional) ## Types ### ChatMessageV2 Represents a single message in the chat history from a given role. - `role`: `user` (User Message) - `content` (ChatMessageV2DiscriminatorMappingUserContent, required) — The content of the message. This can be a string or a list of content blocks. If a string is provided, it will be treated as a text content block. - `role`: `assistant` (Assistant Message) - `citations` (list of Citation, optional) - `content` (AssistantMessageV2Content, optional) - `tool_calls` (list of ToolCallV2, optional) - `tool_plan` (string, optional) — A chain-of-thought style reflection and plan that the model generates when working with Tools. - `role`: `system` (System Message) - `content` (ChatMessageV2DiscriminatorMappingSystemContent, required) - `role`: `tool` (Tool Message) - `content` (ChatMessageV2DiscriminatorMappingToolContent, required) — Outputs from a tool. The content should formatted as a JSON object string, or a list of tool content blocks - `tool_call_id` (string, required) — The id of the associated tool call that has provided the given content ### ToolV2 - `type` (enum, required) - Allowed values: `function` - `function` (ToolV2Function, optional) — The function to be executed. ### V2ChatPostRequestBodyContentApplicationJsonSchemaDocumentsItems ### CitationOptions Options for controlling citation generation. - `mode` (enum, optional) — Defaults to `"enabled"`. Citations are enabled by default for models that support it, but can be turned off by setting `"type": "disabled"`. - Allowed values: `ENABLED`, `DISABLED`, `FAST`, `ACCURATE`, `OFF` ### ResponseFormatV2 Configuration for forcing the model output to adhere to the specified format. Supported on [Command R](https://docs.cohere.com/v2/docs/command-r), [Command R+](https://docs.cohere.com/v2/docs/command-r-plus) and newer models. The model can be forced into outputting JSON objects by setting `{ "type": "json_object" }`. A [JSON Schema](https://json-schema.org/) can optionally be provided, to ensure a specific structure. **Note**: When using `{ "type": "json_object" }` your `message` should always explicitly instruct the model to generate a JSON (eg: *"Generate a JSON ..."*) . Otherwise the model may end up getting stuck generating an infinite stream of characters and eventually run out of context length. **Note**: When `json_schema` is not specified, the generated object can have up to 5 layers of nesting. **Limitation**: The parameter is not supported when used in combinations with the `documents` or `tools` parameters. - `type`: `text` (text) - `type`: `json_object` (json_object) - `json_schema` (JsonResponseFormatV2-uu9wid, optional) — A [JSON schema](https://json-schema.org/overview/what-is-jsonschema) object that the output will adhere to. There are some restrictions we have on the schema, refer to [our guide](https://docs.cohere.com/docs/structured-outputs-json#schema-constraints) for more information. Example (required name and age object): ```json { "type": "object", "properties": { "name": {"type": "string"}, "age": {"type": "integer"} }, "required": ["name", "age"] } ``` **Note**: This field must not be specified when the `type` is set to `"text"`. ### Thinking Configuration for [reasoning features](https://docs.cohere.com/docs/reasoning). - `type` (enum, required) — Reasoning is enabled by default for models that support it, but can be turned off by setting `"type": "disabled"`. - Allowed values: `enabled`, `disabled` - `token_budget` (integer, optional) — The maximum number of tokens the model can use for thinking, which must be set to a positive integer. The model will stop thinking if it reaches the thinking token budget and will proceed with the response. ### AssistantMessageResponse A message from the assistant role can contain text and tool call information. - `role` (enum, required) - Allowed values: `assistant` - `tool_calls` (list of ToolCallV2, optional) - `tool_plan` (string, optional) — A chain-of-thought style reflection and plan that the model generates when working with Tools. - `content` (list of AssistantMessageResponseContentItems, optional) - `citations` (list of Citation, optional) ### Usage - `billed_units` (UsageBilledUnits, optional) - `tokens` (UsageTokens, optional) - `cached_tokens` (double, optional) — The number of prompt tokens that hit the inference cache. ### LogprobItem - `token_ids` (list of integer, required) — The token ids of each token used to construct the text chunk. - `text` (string, optional) — The text chunk for which the log probabilities was calculated. - `logprobs` (list of double, optional) — The log probability of each token used to construct the text chunk. ### ChatMessageV2DiscriminatorMappingUserContent The content of the message. This can be a string or a list of content blocks. If a string is provided, it will be treated as a text content block. ### Citation Citation information containing sources and the text cited. - `start` (integer, optional) — Start index of the cited snippet in the original source text. - `end` (integer, optional) — End index of the cited snippet in the original source text. - `text` (string, optional) — Text snippet that is being cited. - `sources` (list of Source, optional) - `content_index` (integer, optional) — Index of the content block in which this citation appears. - `type` (enum, optional) — The type of citation which indicates what part of the response the citation is for. - Allowed values: `TEXT_CONTENT`, `THINKING_CONTENT`, `PLAN` ### AssistantMessageV2Content ### ToolCallV2 An array of tool calls to be made. - `id` (string, required) - `type` (enum, required) - Allowed values: `function` - `function` (ToolCallV2Function, optional) ### ChatMessageV2DiscriminatorMappingSystemContent ### ChatMessageV2DiscriminatorMappingToolContent Outputs from a tool. The content should formatted as a JSON object string, or a list of tool content blocks ### ToolV2Function The function to be executed. - `name` (string, required) — The name of the function. - `parameters` (ToolV2-6eoehf, required) — The parameters of the function as a JSON schema. - `description` (string, optional) — The description of the function. ### Document Relevant information that could be used by the model to generate a more accurate reply. The content of each document are generally short (should be under 300 words). Metadata should be used to provide additional information, both the key name and the value will be passed to the model. - `data` (Document-qmvpd9, required) — A relevant document that the model can cite to generate a more accurate reply. Each document is a string-any dictionary. - `id` (string, optional) — Unique identifier for this document which will be referenced in citations. If not provided an ID will be automatically generated. ### JsonResponseFormatV2-uu9wid A [JSON schema](https://json-schema.org/overview/what-is-jsonschema) object that the output will adhere to. There are some restrictions we have on the schema, refer to [our guide](https://docs.cohere.com/docs/structured-outputs-json#schema-constraints) for more information. Example (required name and age object): ```json { "type": "object", "properties": { "name": {"type": "string"}, "age": {"type": "integer"} }, "required": ["name", "age"] } ``` **Note**: This field must not be specified when the `type` is set to `"text"`. ### AssistantMessageResponseContentItems - `type`: `text` (text) - `text` (string, required) - `type`: `thinking` (thinking) - `thinking` (string, required) ### UsageBilledUnits - `input_tokens` (double, optional) — The number of billed input tokens. - `output_tokens` (double, optional) — The number of billed output tokens. - `search_units` (double, optional) — The number of billed search units. - `classifications` (double, optional) — The number of billed classifications units. ### UsageTokens - `input_tokens` (double, optional) — The number of tokens used as input to the model. - `output_tokens` (double, optional) — The number of tokens produced by the model. ### Source A source object containing information about the source of the data cited. - `type`: `tool` (Tool Output) - `id` (string, optional) — The unique identifier of the document - `tool_output` (map from string to any, optional) - `type`: `document` (document) - `document` (map from string to any, optional) - `id` (string, optional) — The unique identifier of the document ### ToolCallV2Function - `name` (string, optional) - `arguments` (string, optional) ### ToolV2-6eoehf The parameters of the function as a JSON schema. ### Document-qmvpd9 A relevant document that the model can cite to generate a more accurate reply. Each document is a string-any dictionary. ## Examples ### Default **Request** ```json { "stream": false, "model": "command-a-plus-05-2026", "messages": [ { "role": "user", "content": "Tell me about LLMs" } ] } ``` **Response** ```json { "id": "c14c80c3-18eb-4519-9460-6c92edd8cfb4", "finish_reason": "COMPLETE", "message": { "role": "assistant", "content": [ { "type": "text", "text": "LLMs stand for Large Language Models, which are a type of neural network model specialized in processing and generating human language. They are designed to understand and respond to natural language input and have become increasingly popular and valuable in recent years.\n\nLLMs are trained on vast amounts of text data, enabling them to learn patterns, grammar, and semantic meanings present in the language. These models can then be used for various natural language processing tasks, such as text generation, summarization, question answering, machine translation, sentiment analysis, and even some aspects of natural language understanding.\n\nSome well-known examples of LLMs include:\n\n1. GPT-3 (Generative Pre-trained Transformer 3) — An open-source LLM developed by OpenAI, capable of generating human-like text and performing various language tasks.\n\n2. BERT (Bidirectional Encoder Representations from Transformers) — A Google-developed LLM that is particularly good at understanding contextual relationships in text, and is widely used for natural language understanding tasks like sentiment analysis and named entity recognition.\n\n3. T5 (Text-to-Text Transfer Transformer) — Also from Google, T5 is a flexible LLM that frames all language tasks as text-to-text problems, where the model learns to generate output text based on input text prompts.\n\n4. RoBERTa (Robustly Optimized BERT Approach) — A variant of BERT that uses additional training techniques to improve performance.\n\n5. DeBERTa (Decoding-enhanced BERT with disentangled attention) — Another variant of BERT that introduces a new attention mechanism.\n\nLLMs have become increasingly powerful and larger in scale, improving the accuracy and sophistication of language tasks. They are also being used as a foundation for developing various applications, including chatbots, content recommendation systems, language translation services, and more.\nThe future of LLMs holds the potential for even more sophisticated language technologies, with ongoing research and development focused on enhancing their capabilities, improving efficiency, and exploring their applications in various domains." } ] }, "usage": { "billed_units": { "input_tokens": 5, "output_tokens": 418 }, "tokens": { "input_tokens": 71, "output_tokens": 418 } } } ``` **SDK Code** ```typescript Default const { CohereClientV2 } = require('cohere-ai'); const cohere = new CohereClientV2({}); (async () => { const response = await cohere.chat({ model: 'command-a-plus-05-2026', messages: [ { role: 'user', content: 'Tell me about LLMs', }, ], }); console.log(response); })(); ``` ```python Default import cohere co = cohere.ClientV2() response = co.chat( model="command-a-plus-05-2026", messages=[{"role": "user", "content": "Tell me about LLMs"}], ) print(response) ``` ```python Async import cohere import asyncio co = cohere.AsyncClientV2() async def main(): response = await co.chat( model="command-a-plus-05-2026", messages=[{"role": "user", "content": "Tell me about LLMs"}], ) print(response) asyncio.run(main()) ``` ```go Default package main import ( "context" "log" "os" cohere "github.com/cohere-ai/cohere-go/v2" client "github.com/cohere-ai/cohere-go/v2/client" ) func main() { co := client.NewClient(client.WithToken(os.Getenv("CO_API_KEY"))) resp, err := co.V2.Chat( context.TODO(), &cohere.V2ChatRequest{ Model: "command-a-plus-05-2026", Messages: cohere.ChatMessages{ { Role: "user", User: &cohere.UserMessageV2{ Content: &cohere.UserMessageV2Content{ String: "Tell me about LLMs", }, }, }, }, }, ) if err != nil { log.Fatal(err) } log.Printf("%+v", resp) } ``` ```java Default /* (C)2024 */ package chatv2post; import com.cohere.api.Cohere; import com.cohere.api.resources.v2.requests.V2ChatRequest; import com.cohere.api.types.*; import java.util.List; public class Default { public static void main(String[] args) { Cohere cohere = Cohere.builder().clientName("snippet").build(); ChatResponse response = cohere .v2() .chat( V2ChatRequest.builder() .model("command-a-plus-05-2026") .messages( List.of( ChatMessageV2.user( UserMessage.builder() .content(UserMessageContent.of("Tell me about LLMs")) .build()))) .build()); System.out.println(response); } } ``` ```ruby Default require 'uri' require 'net/http' url = URI("https://api.cohere.com/v2/chat") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"stream\": false,\n \"model\": \"command-a-plus-05-2026\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Tell me about LLMs\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```php Default request('POST', 'https://api.cohere.com/v2/chat', [ 'body' => '{ "stream": false, "model": "command-a-plus-05-2026", "messages": [ { "role": "user", "content": "Tell me about LLMs" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Default using RestSharp; var client = new RestClient("https://api.cohere.com/v2/chat"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"stream\": false,\n \"model\": \"command-a-plus-05-2026\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Tell me about LLMs\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Default import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "stream": false, "model": "command-a-plus-05-2026", "messages": [ [ "role": "user", "content": "Tell me about LLMs" ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.cohere.com/v2/chat")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Documents **Request** ```json { "stream": false, "model": "command-a-plus-05-2026", "messages": [ { "role": "user", "content": "Who is more popular: Nsync or Backstreet Boys?" } ], "documents": [ { "data": { "content": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak." } }, { "data": { "content": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold." } }, { "data": { "content": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\nYet the way many music consumers – especially teenagers and young women’s – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\n\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers." } }, { "data": { "content": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon?\nAs usual, I’ll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC‘s albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures." } } ] } ``` **Response** ```json { "id": "c14c80c3-18eb-4519-9460-6c92edd8cfb4", "finish_reason": "COMPLETE", "message": { "role": "assistant", "content": [ { "type": "text", "text": "Both NSync and Backstreet Boys were extremely popular at the turn of the millennium. Backstreet Boys had massive album sales across the globe, great singles sales, plenty of chart-topping releases, hyped tours, and tremendous media coverage. NSync also had huge sales, with their album No Strings Attached selling 2.4 million units in its first week. They also had the second fastest-selling album of the Soundscan era before 2015, with Celebrity debuting at 1.88 million units sold.\n\nWhile it is difficult to say for sure which of the two bands was more popular, Backstreet Boys did have success in some countries that were traditionally hard to penetrate for Western artists." } ], "citations": [ { "start": 36, "end": 84, "text": "extremely popular at the turn of the millennium.", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.", "title": "CSPC: NSYNC Popularity Analysis - ChartMasters" }, "id": "doc:1" } ] }, { "start": 105, "end": 141, "text": "massive album sales across the globe", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.", "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters" }, "id": "doc:0" } ] }, { "start": 143, "end": 162, "text": "great singles sales", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.", "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters" }, "id": "doc:0" } ] }, { "start": 164, "end": 196, "text": "plenty of chart-topping releases", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.", "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters" }, "id": "doc:0" } ] }, { "start": 198, "end": 209, "text": "hyped tours", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.", "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters" }, "id": "doc:0" } ] }, { "start": 215, "end": 241, "text": "tremendous media coverage.", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.", "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters" }, "id": "doc:0" } ] }, { "start": 280, "end": 350, "text": "album No Strings Attached selling 2.4 million units in its first week.", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.", "title": "CSPC: NSYNC Popularity Analysis - ChartMasters" }, "id": "doc:1" } ] }, { "start": 369, "end": 430, "text": "second fastest-selling album of the Soundscan era before 2015", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.", "title": "CSPC: NSYNC Popularity Analysis - ChartMasters" }, "id": "doc:1" } ] }, { "start": 437, "end": 483, "text": "Celebrity debuting at 1.88 million units sold.", "sources": [ { "type": "document", "document": { "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.", "title": "CSPC: NSYNC Popularity Analysis - ChartMasters" }, "id": "doc:1" } ] }, { "start": 589, "end": 677, "text": "success in some countries that were traditionally hard to penetrate for Western artists.", "sources": [ { "type": "document", "document": { "snippet": "1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\nYet the way many music consumers – especially teenagers and young women’s – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\n\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers.", "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters" }, "id": "doc:2" } ] } ] }, "usage": { "billed_units": { "input_tokens": 682, "output_tokens": 143 }, "tokens": { "input_tokens": 1380, "output_tokens": 434 } } } ``` **SDK Code** ```typescript Documents const { CohereClientV2 } = require('cohere-ai'); const cohere = new CohereClientV2({}); (async () => { const response = await cohere.chat({ model: 'command-a-plus-05-2026', messages: [ { role: 'user', content: 'Who is more popular: Nsync or Backstreet Boys?', }, ], documents: [ { data: { title: 'CSPC: Backstreet Boys Popularity Analysis - ChartMasters', snippet: '↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.', }, }, { data: { title: 'CSPC: NSYNC Popularity Analysis - ChartMasters', snippet: "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven't study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn't a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.", }, }, { data: { title: 'CSPC: Backstreet Boys Popularity Analysis - ChartMasters', snippet: " 1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\n\nYet the way many music consumers – especially teenagers and young women's – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\n\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers.", }, }, { data: { title: 'CSPC: NSYNC Popularity Analysis - ChartMasters', snippet: " Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon?\n\nAs usual, I'll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC's albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures.", }, }, ], }); console.log(response); })(); ``` ```python Documents import cohere co = cohere.ClientV2() response = co.chat( model="command-a-plus-05-2026", messages=[{ "role": "user", "content": "Who is more popular: Nsync or Backstreet Boys?" }], documents=[ { "data": { "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.", } }, { "data": { "title": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.", } }, { "data": { "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": " 1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\n\nYet the way many music consumers – especially teenagers and young women’s – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\n\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers.", } }, { "data": { "title": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": " Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon?\n\nAs usual, I’ll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC‘s albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures.", } } ], ) print(response) ``` ```java Documents /* (C)2024 */ package chatv2post; import com.cohere.api.Cohere; import com.cohere.api.resources.v2.requests.V2ChatRequest; import com.cohere.api.resources.v2.types.V2ChatRequestDocumentsItem; import com.cohere.api.types.*; import java.util.List; import java.util.Map; public class Documents { public static void main(String[] args) { Cohere cohere = Cohere.builder().clientName("snippet").build(); ChatResponse response = cohere .v2() .chat( V2ChatRequest.builder() .model("command-a-plus-05-2026") .messages( List.of( ChatMessageV2.user( UserMessage.builder() .content( UserMessageContent.of( "Who is more popular: Nsync or Backstreet Boys?")) .build()))) .documents( List.of( V2ChatRequestDocumentsItem.of( Document.builder() .data( Map.of( "title", "CSPC: Backstreet Boys Popularity Analysis -" + " ChartMasters", "snippet", "↓ Skip to Main Content\n\n" + "Music industry – One step closer to being" + " accurate\n\n" + "CSPC: Backstreet Boys Popularity Analysis\n\n" + "Hernán Lopez Posted on February 9, 2017 Posted" + " in CSPC 72 Comments Tagged with Backstreet" + " Boys, Boy band\n\n" + "At one point, Backstreet Boys defined success:" + " massive albums sales across the globe, great" + " singles sales, plenty of chart topping" + " releases, hugely hyped tours and tremendous" + " media coverage.\n\n" + "It is true that they benefited from" + " extraordinarily good market conditions in all" + " markets. After all, the all-time record year" + " for the music business, as far as revenues in" + " billion dollars are concerned, was actually" + " 1999. That is, back when this five men group" + " was at its peak.")) .build()), V2ChatRequestDocumentsItem.of( Document.builder() .data( Map.of( "title", "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet", "↓ Skip to Main Content\n\n" + "Music industry – One step closer to being" + " accurate\n\n" + "CSPC: NSYNC Popularity Analysis\n\n" + "MJD Posted on February 9, 2018 Posted in CSPC" + " 27 Comments Tagged with Boy band, N'Sync\n\n" + "At the turn of the millennium three teen acts" + " were huge in the US, the Backstreet Boys," + " Britney Spears and NSYNC. The latter is the" + " only one we haven't study so far. It took 15" + " years and Adele to break their record of 2,4" + " million units sold of No Strings Attached in" + " its first week alone.\n\n" + "It wasn't a fluke, as the second fastest" + " selling album of the Soundscan era prior 2015," + " was also theirs since Celebrity debuted with" + " 1,88 million units sold.")) .build()), V2ChatRequestDocumentsItem.of( Document.builder() .data( Map.of( "title", "CSPC: Backstreet Boys Popularity Analysis -" + " ChartMasters", "snippet", " 1997, 1998, 2000 and 2001 also rank amongst some" + " of the very best years.\n\n" + "Yet the way many music consumers – especially" + " teenagers and young women's – embraced their" + " output deserves its own chapter. If Jonas" + " Brothers and more recently One Direction" + " reached a great level of popularity during the" + " past decade, the type of success achieved by" + " Backstreet Boys is in a completely different" + " level as they really dominated the business" + " for a few years all over the world, including" + " in some countries that were traditionally hard" + " to penetrate for Western artists.\n\n" + "We will try to analyze the extent of that" + " hegemony with this new article with final" + " results which will more than surprise many" + " readers.")) .build()), V2ChatRequestDocumentsItem.of( Document.builder() .data( Map.of( "title", "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet", " Was the teen group led by Justin Timberlake" + " really that big? Was it only in the US where" + " they found success? Or were they a global" + " phenomenon?\n\n" + "As usual, I'll be using the Commensurate Sales" + " to Popularity Concept in order to relevantly" + " gauge their results. This concept will not" + " only bring you sales information for all" + " NSYNC's albums, physical and download singles," + " as well as audio and video streaming, but it" + " will also determine their true popularity. If" + " you are not yet familiar with the CSPC method," + " the next page explains it with a short video." + " I fully recommend watching the video before" + " getting into the sales figures.")) .build()))) .build()); System.out.println(response); } } ``` ```go Documents package main import ( "context" "log" "os" cohere "github.com/cohere-ai/cohere-go/v2" client "github.com/cohere-ai/cohere-go/v2/client" ) func main() { co := client.NewClient(client.WithToken(os.Getenv("CO_API_KEY"))) resp, err := co.V2.Chat( context.TODO(), &cohere.V2ChatRequest{ Model: "command-a-plus-05-2026", Messages: cohere.ChatMessages{ { Role: "user", User: &cohere.UserMessageV2{ Content: &cohere.UserMessageV2Content{ String: "Who is more popular: Nsync or Backstreet Boys?", }, }, }, }, Documents: []*cohere.V2ChatRequestDocumentsItem{ { Document: &cohere.Document{ Data: map[string]interface{}{ "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: Backstreet Boys Popularity Analysis\n\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\n\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\n\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.", }, }, }, { Document: &cohere.Document{ Data: map[string]interface{}{ "title": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\n\nMusic industry – One step closer to being accurate\n\nCSPC: NSYNC Popularity Analysis\n\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\n\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven't study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\n\nIt wasn't a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.", }, }, }, { Document: &cohere.Document{ Data: map[string]interface{}{ "title": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": " 1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\n\nYet the way many music consumers – especially teenagers and young women's – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\n\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers.", }, }, }, { Document: &cohere.Document{ Data: map[string]interface{}{ "title": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": " Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon?\n\nAs usual, I'll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC's albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures.", }, }, }, }, }, ) if err != nil { log.Fatal(err) } log.Printf("%+v", resp) } ``` ```ruby Documents require 'uri' require 'net/http' url = URI("https://api.cohere.com/v2/chat") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"stream\": false,\n \"model\": \"command-a-plus-05-2026\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Who is more popular: Nsync or Backstreet Boys?\"\n }\n ],\n \"documents\": [\n {\n \"data\": {\n \"content\": \"CSPC: Backstreet Boys Popularity Analysis - ChartMasters\",\n \"snippet\": \"↓ Skip to Main Content\\n\\nMusic industry – One step closer to being accurate\\n\\nCSPC: Backstreet Boys Popularity Analysis\\n\\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\\n\\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\\n\\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.\"\n }\n },\n {\n \"data\": {\n \"content\": \"CSPC: NSYNC Popularity Analysis - ChartMasters\",\n \"snippet\": \"↓ Skip to Main Content\\n\\nMusic industry – One step closer to being accurate\\n\\nCSPC: NSYNC Popularity Analysis\\n\\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\\n\\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\\n\\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.\"\n }\n },\n {\n \"data\": {\n \"content\": \"CSPC: Backstreet Boys Popularity Analysis - ChartMasters\",\n \"snippet\": \"1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\\nYet the way many music consumers – especially teenagers and young women’s – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\\n\\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers.\"\n }\n },\n {\n \"data\": {\n \"content\": \"CSPC: NSYNC Popularity Analysis - ChartMasters\",\n \"snippet\": \"Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon?\\nAs usual, I’ll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC‘s albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures.\"\n }\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```php Documents request('POST', 'https://api.cohere.com/v2/chat', [ 'body' => '{ "stream": false, "model": "command-a-plus-05-2026", "messages": [ { "role": "user", "content": "Who is more popular: Nsync or Backstreet Boys?" } ], "documents": [ { "data": { "content": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\\n\\nMusic industry – One step closer to being accurate\\n\\nCSPC: Backstreet Boys Popularity Analysis\\n\\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\\n\\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\\n\\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak." } }, { "data": { "content": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content\\n\\nMusic industry – One step closer to being accurate\\n\\nCSPC: NSYNC Popularity Analysis\\n\\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N\'Sync\\n\\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\\n\\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold." } }, { "data": { "content": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\\nYet the way many music consumers – especially teenagers and young women’s – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\\n\\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers." } }, { "data": { "content": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon?\\nAs usual, I’ll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC‘s albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures." } } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Documents using RestSharp; var client = new RestClient("https://api.cohere.com/v2/chat"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"stream\": false,\n \"model\": \"command-a-plus-05-2026\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Who is more popular: Nsync or Backstreet Boys?\"\n }\n ],\n \"documents\": [\n {\n \"data\": {\n \"content\": \"CSPC: Backstreet Boys Popularity Analysis - ChartMasters\",\n \"snippet\": \"↓ Skip to Main Content\\n\\nMusic industry – One step closer to being accurate\\n\\nCSPC: Backstreet Boys Popularity Analysis\\n\\nHernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band\\n\\nAt one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage.\\n\\nIt is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak.\"\n }\n },\n {\n \"data\": {\n \"content\": \"CSPC: NSYNC Popularity Analysis - ChartMasters\",\n \"snippet\": \"↓ Skip to Main Content\\n\\nMusic industry – One step closer to being accurate\\n\\nCSPC: NSYNC Popularity Analysis\\n\\nMJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync\\n\\nAt the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone.\\n\\nIt wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold.\"\n }\n },\n {\n \"data\": {\n \"content\": \"CSPC: Backstreet Boys Popularity Analysis - ChartMasters\",\n \"snippet\": \"1997, 1998, 2000 and 2001 also rank amongst some of the very best years.\\nYet the way many music consumers – especially teenagers and young women’s – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists.\\n\\nWe will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers.\"\n }\n },\n {\n \"data\": {\n \"content\": \"CSPC: NSYNC Popularity Analysis - ChartMasters\",\n \"snippet\": \"Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon?\\nAs usual, I’ll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC‘s albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures.\"\n }\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Documents import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "stream": false, "model": "command-a-plus-05-2026", "messages": [ [ "role": "user", "content": "Who is more popular: Nsync or Backstreet Boys?" ] ], "documents": [["data": [ "content": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content Music industry – One step closer to being accurate CSPC: Backstreet Boys Popularity Analysis Hernán Lopez Posted on February 9, 2017 Posted in CSPC 72 Comments Tagged with Backstreet Boys, Boy band At one point, Backstreet Boys defined success: massive albums sales across the globe, great singles sales, plenty of chart topping releases, hugely hyped tours and tremendous media coverage. It is true that they benefited from extraordinarily good market conditions in all markets. After all, the all-time record year for the music business, as far as revenues in billion dollars are concerned, was actually 1999. That is, back when this five men group was at its peak." ]], ["data": [ "content": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "↓ Skip to Main Content Music industry – One step closer to being accurate CSPC: NSYNC Popularity Analysis MJD Posted on February 9, 2018 Posted in CSPC 27 Comments Tagged with Boy band, N'Sync At the turn of the millennium three teen acts were huge in the US, the Backstreet Boys, Britney Spears and NSYNC. The latter is the only one we haven’t study so far. It took 15 years and Adele to break their record of 2,4 million units sold of No Strings Attached in its first week alone. It wasn’t a fluke, as the second fastest selling album of the Soundscan era prior 2015, was also theirs since Celebrity debuted with 1,88 million units sold." ]], ["data": [ "content": "CSPC: Backstreet Boys Popularity Analysis - ChartMasters", "snippet": "1997, 1998, 2000 and 2001 also rank amongst some of the very best years. Yet the way many music consumers – especially teenagers and young women’s – embraced their output deserves its own chapter. If Jonas Brothers and more recently One Direction reached a great level of popularity during the past decade, the type of success achieved by Backstreet Boys is in a completely different level as they really dominated the business for a few years all over the world, including in some countries that were traditionally hard to penetrate for Western artists. We will try to analyze the extent of that hegemony with this new article with final results which will more than surprise many readers." ]], ["data": [ "content": "CSPC: NSYNC Popularity Analysis - ChartMasters", "snippet": "Was the teen group led by Justin Timberlake really that big? Was it only in the US where they found success? Or were they a global phenomenon? As usual, I’ll be using the Commensurate Sales to Popularity Concept in order to relevantly gauge their results. This concept will not only bring you sales information for all NSYNC‘s albums, physical and download singles, as well as audio and video streaming, but it will also determine their true popularity. If you are not yet familiar with the CSPC method, the next page explains it with a short video. I fully recommend watching the video before getting into the sales figures." ]]] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.cohere.com/v2/chat")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Tools **Request** ```json { "stream": false, "model": "command-r", "messages": [ { "role": "user", "content": "Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the 'Electronics' category, for example their prices and stock levels?" } ], "tools": [ { "type": "function", "function": { "name": "query_daily_sales_report", "parameters": { "properties": { "day": { "description": "Retrieves sales data for this day, formatted as YYYY-MM-DD.", "type": "str" } }, "required": [ "day" ], "type": "object", "x-fern-type-name": "tools-by6k68" }, "description": "Connects to a database to retrieve overall sales volumes and sales information for a given day." } }, { "type": "function", "function": { "name": "query_product_catalog", "parameters": { "properties": { "category": { "description": "Retrieves product information data for all products in this category.", "type": "str" } }, "required": [ "category" ], "type": "object", "x-fern-type-name": "tools-o09qd6" }, "description": "Connects to a a product catalog with information about all the products being sold, including categories, prices, and stock levels." } } ] } ``` **Response** ```json { "id": "9e5f00aa-bf1e-481a-abe3-0eceac18c3ec", "finish_reason": "TOOL_CALL", "message": { "role": "assistant", "tool_calls": [ { "id": "query_daily_sales_report_hgxxmkby3wta", "type": "function", "function": { "name": "query_daily_sales_report", "arguments": "{\"day\": \"2023-09-29\"}" } }, { "id": "query_product_catalog_rpg0z5h8yyz2", "type": "function", "function": { "name": "query_product_catalog", "arguments": "{\"category\": \"Electronics\"}" } } ], "content": [ { "type": "thinking", "thinking": "I will first find the sales summary for 29th September 2023. Then, I will find the details of the products in the 'Electronics' category." } ] }, "usage": { "billed_units": { "input_tokens": 127, "output_tokens": 69 }, "tokens": { "input_tokens": 1032, "output_tokens": 124 } } } ``` **SDK Code** ```typescript Tools const { CohereClientV2 } = require('cohere-ai'); const cohere = new CohereClientV2({}); (async () => { const response = await cohere.chat({ model: 'command-a-plus-05-2026', messages: [ { role: 'user', content: "Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the 'Electronics' category, for example their prices and stock levels?", }, ], tools: [ { type: 'function', function: { name: 'query_daily_sales_report', description: 'Connects to a database to retrieve overall sales volumes and sales information for a given day.', parameters: { type: 'object', properties: { day: { description: 'Retrieves sales data for this day, formatted as YYYY-MM-DD.', type: 'string', }, }, required: ['day'], }, }, }, { type: 'function', function: { name: 'query_product_catalog', description: 'Connects to a product catalog with information about all the products being sold, including categories, prices, and stock levels.', parameters: { type: 'object', properties: { category: { description: 'Retrieves product information data for all products in this category.', type: 'string', }, }, required: ['category'], }, }, }, ], }); console.log(response); })(); ``` ```python Tools import cohere co = cohere.ClientV2() response = co.chat( model="command-a-reasoning-08-2025", messages=[ { "role": "user", "content": "Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the 'Electronics' category, for example their prices and stock levels?", } ], tools=[ cohere.ToolV2( type="function", function={ "name": "query_daily_sales_report", "description": "Connects to a database to retrieve overall sales volumes and sales information for a given day.", "parameters": { "type": "object", "properties": { "day": { "description": "Retrieves sales data for this day, formatted as YYYY-MM-DD.", "type": "string", } }, "required": ["day"], }, }, ), cohere.ToolV2( type="function", function={ "name": "query_product_catalog", "description": "Connects to a product catalog with information about all the products being sold, including categories, prices, and stock levels.", "parameters": { "type": "object", "properties": { "category": { "description": "Retrieves product information data for all products in this category.", "type": "string", } }, "required": ["category"], }, }, ), ], ) print(response) ``` ```java Tools /* (C)2024 */ package chatv2post; import com.cohere.api.Cohere; import com.cohere.api.resources.v2.requests.V2ChatRequest; import com.cohere.api.types.*; import java.util.List; import java.util.Map; public class Tools { public static void main(String[] args) { Cohere cohere = Cohere.builder().clientName("snippet").build(); ChatResponse response = cohere .v2() .chat( V2ChatRequest.builder() .model("command-a-reasoning-08-2025") .messages( List.of( ChatMessageV2.user( UserMessage.builder() .content( UserMessageContent.of( "Can you provide a sales summary for 29th September" + " 2023, and also give me some details about the" + " products in the 'Electronics' category, for" + " example their prices and stock levels?")) .build()))) .tools( List.of( ToolV2.builder() .type("function") .function( ToolV2Function.builder() .name("query_daily_sales_report") .description( "Connects to a database to retrieve overall sales" + " volumes and sales information for a given" + " day.") .parameters( Map.of( "type", "object", "properties", Map.of( "day", Map.of( "description", "Retrieves sales data for this day," + " formatted as YYYY-MM-DD.", "type", "string")), "required", List.of("day"))) .build()) .build(), ToolV2.builder() .type("function") .function( ToolV2Function.builder() .name("query_product_catalog") .description( "Connects to a product catalog with information" + " about all the products being sold, including" + " categories, prices, and stock levels.") .parameters( Map.of( "type", "object", "properties", Map.of( "category", Map.of( "description", "Retrieves product information data for all" + " products in this category.", "type", "string")), "required", List.of("category"))) .build()) .build())) .build()); System.out.println(response); } } ``` ```go Tools package main import ( "context" "log" "os" cohere "github.com/cohere-ai/cohere-go/v2" client "github.com/cohere-ai/cohere-go/v2/client" ) func main() { co := client.NewClient(client.WithToken(os.Getenv("CO_API_KEY"))) resp, err := co.V2.Chat( context.TODO(), &cohere.V2ChatRequest{ Model: "command-a-plus-05-2026", Messages: cohere.ChatMessages{ { Role: "user", User: &cohere.UserMessageV2{ Content: &cohere.UserMessageV2Content{ String: "Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the 'Electronics' category, for example their prices and stock levels?", }, }, }, }, Tools: []*cohere.ToolV2{ { Function: &cohere.ToolV2Function{ Name: "query_daily_sales_report", Description: cohere.String("Connects to a database to retrieve overall sales volumes and sales information for a given day."), Parameters: map[string]interface{}{ "type": "object", "properties": map[string]interface{}{ "day": map[string]interface{}{ "type": "string", "description": "Retrieves sales data for this day, formatted as YYYY-MM-DD.", }, }, "required": []string{"day"}, }, }, }, { Function: &cohere.ToolV2Function{ Name: "query_product_catalog", Description: cohere.String("Connects to a product catalog with information about all the products being sold, including categories, prices, and stock levels."), Parameters: map[string]interface{}{ "type": "object", "properties": map[string]interface{}{ "category": map[string]interface{}{ "type": "string", "description": "Retrieves product information data for all products in this category.", }, }, "required": []string{"category"}, }, }, }, }, }, ) if err != nil { log.Fatal(err) } log.Printf("%+v", resp) } ``` ```ruby Tools require 'uri' require 'net/http' url = URI("https://api.cohere.com/v2/chat") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"stream\": false,\n \"model\": \"command-r\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the 'Electronics' category, for example their prices and stock levels?\"\n }\n ],\n \"tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"query_daily_sales_report\",\n \"parameters\": {\n \"properties\": {\n \"day\": {\n \"description\": \"Retrieves sales data for this day, formatted as YYYY-MM-DD.\",\n \"type\": \"str\"\n }\n },\n \"required\": [\n \"day\"\n ],\n \"type\": \"object\",\n \"x-fern-type-name\": \"tools-by6k68\"\n },\n \"description\": \"Connects to a database to retrieve overall sales volumes and sales information for a given day.\"\n }\n },\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"query_product_catalog\",\n \"parameters\": {\n \"properties\": {\n \"category\": {\n \"description\": \"Retrieves product information data for all products in this category.\",\n \"type\": \"str\"\n }\n },\n \"required\": [\n \"category\"\n ],\n \"type\": \"object\",\n \"x-fern-type-name\": \"tools-o09qd6\"\n },\n \"description\": \"Connects to a a product catalog with information about all the products being sold, including categories, prices, and stock levels.\"\n }\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```php Tools request('POST', 'https://api.cohere.com/v2/chat', [ 'body' => '{ "stream": false, "model": "command-r", "messages": [ { "role": "user", "content": "Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the \'Electronics\' category, for example their prices and stock levels?" } ], "tools": [ { "type": "function", "function": { "name": "query_daily_sales_report", "parameters": { "properties": { "day": { "description": "Retrieves sales data for this day, formatted as YYYY-MM-DD.", "type": "str" } }, "required": [ "day" ], "type": "object", "x-fern-type-name": "tools-by6k68" }, "description": "Connects to a database to retrieve overall sales volumes and sales information for a given day." } }, { "type": "function", "function": { "name": "query_product_catalog", "parameters": { "properties": { "category": { "description": "Retrieves product information data for all products in this category.", "type": "str" } }, "required": [ "category" ], "type": "object", "x-fern-type-name": "tools-o09qd6" }, "description": "Connects to a a product catalog with information about all the products being sold, including categories, prices, and stock levels." } } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Tools using RestSharp; var client = new RestClient("https://api.cohere.com/v2/chat"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"stream\": false,\n \"model\": \"command-r\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the 'Electronics' category, for example their prices and stock levels?\"\n }\n ],\n \"tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"query_daily_sales_report\",\n \"parameters\": {\n \"properties\": {\n \"day\": {\n \"description\": \"Retrieves sales data for this day, formatted as YYYY-MM-DD.\",\n \"type\": \"str\"\n }\n },\n \"required\": [\n \"day\"\n ],\n \"type\": \"object\",\n \"x-fern-type-name\": \"tools-by6k68\"\n },\n \"description\": \"Connects to a database to retrieve overall sales volumes and sales information for a given day.\"\n }\n },\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"query_product_catalog\",\n \"parameters\": {\n \"properties\": {\n \"category\": {\n \"description\": \"Retrieves product information data for all products in this category.\",\n \"type\": \"str\"\n }\n },\n \"required\": [\n \"category\"\n ],\n \"type\": \"object\",\n \"x-fern-type-name\": \"tools-o09qd6\"\n },\n \"description\": \"Connects to a a product catalog with information about all the products being sold, including categories, prices, and stock levels.\"\n }\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Tools import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "stream": false, "model": "command-r", "messages": [ [ "role": "user", "content": "Can you provide a sales summary for 29th September 2023, and also give me some details about the products in the 'Electronics' category, for example their prices and stock levels?" ] ], "tools": [ [ "type": "function", "function": [ "name": "query_daily_sales_report", "parameters": [ "properties": ["day": [ "description": "Retrieves sales data for this day, formatted as YYYY-MM-DD.", "type": "str" ]], "required": ["day"], "type": "object", "x-fern-type-name": "tools-by6k68" ], "description": "Connects to a database to retrieve overall sales volumes and sales information for a given day." ] ], [ "type": "function", "function": [ "name": "query_product_catalog", "parameters": [ "properties": ["category": [ "description": "Retrieves product information data for all products in this category.", "type": "str" ]], "required": ["category"], "type": "object", "x-fern-type-name": "tools-o09qd6" ], "description": "Connects to a a product catalog with information about all the products being sold, including categories, prices, and stock levels." ] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.cohere.com/v2/chat")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Images **Request** ```json { "stream": false, "model": "command-a-vision-07-2025", "messages": [ { "role": "user", "content": [ { "text": "Describe this image", "type": "text" }, { "image_url": { "detail": "auto", "url": "https://cohere.com/favicon-32x32.png" }, "type": "image_url" } ] } ] } ``` **Response** ```json { "id": "c14c80c3-18eb-4519-9460-6c92edd8cfb4", "finish_reason": "COMPLETE", "message": { "role": "assistant", "content": [ { "type": "text", "text": "The image you've provided is quite abstract and blurred, making it challenging to discern specific details. However, I can describe the general shapes and colors present:\n\n1. **Shapes and Colors:**\n - There are three main shapes in the image.\n - The largest shape at the top is a dark green, irregular oval.\n - Below it, on the left, there's a smaller, bright orange circle.\n - To the right of the orange circle, there's another oval shape, this one in a light purple color.\n\n2. **Arrangement:**\n - The green oval is positioned at the top center of the image.\n - The orange circle is directly below the green oval, slightly to the left.\n - The purple oval is to the right of the orange circle, forming a rough triangular arrangement with the other two shapes.\n\n3. **Blurriness:**\n - The entire image is blurred, which softens the edges of the shapes and makes it difficult to identify any specific details or textures within the shapes.\n\nGiven the abstract nature of the image, it's open to interpretation. The shapes could represent various objects or concepts depending on the viewer's perspective. If you have any specific questions about the image or need further clarification, feel free to ask!\n" } ] }, "usage": { "billed_units": { "input_tokens": 5, "output_tokens": 418 }, "tokens": { "input_tokens": 71, "output_tokens": 418 } } } ``` **SDK Code** ```typescript Images const { CohereClientV2 } = require('cohere-ai'); const cohere = new CohereClientV2({}); (async () => { const response = await cohere.chat({ model: 'command-a-vision-07-2025', messages: [ { role: 'user', content: [ { type: 'text', text: 'Describe this image' }, { type: 'image_url', imageUrl: { // Can be either a base64 data URI or a web URL. url: 'https://cohere.com/favicon-32x32.png', detail: 'auto', }, }, ], }, ], }); console.log(response.message.content[0].text); })(); ``` ```python Images import cohere co = cohere.ClientV2() response = co.chat( model="command-a-vision-07-2025", messages=[ { "role": "user", "content": [ { "type": "text", "text": "Describe this image" }, { "type": "image_url", "image_url": { # Can be either a base64 data URI or a web URL. "url": "https://cohere.com/favicon-32x32.png", "detail": "auto" } } ] } ] ) print(response) ``` ```java Images /* (C)2024 */ package chatv2post; import java.util.List; import com.cohere.api.Cohere; import com.cohere.api.resources.v2.requests.V2ChatRequest; import com.cohere.api.types.ChatMessageV2; import com.cohere.api.types.ChatResponse; import com.cohere.api.types.Content; import com.cohere.api.types.ImageContent; import com.cohere.api.types.ImageUrl; import com.cohere.api.types.TextContent; import com.cohere.api.types.UserMessage; import com.cohere.api.types.UserMessageContent; public class Image { public static void main(String[] args) { Cohere cohere = Cohere.builder().clientName("snippet").build(); ChatResponse response = cohere .v2() .chat( V2ChatRequest.builder() .model("command-a-vision-07-2025") .messages( List.of( ChatMessageV2.user( UserMessage.builder() .content( UserMessageContent.of( List.of( Content.text( TextContent.builder() .text("Describe this image") .build()), Content.imageUrl( ImageContent.builder() .imageUrl( ImageUrl.builder() // Can be either a base64 data URI or a web URL. .url( "https://cohere.com/favicon-32x32.png") .build()) .build())))) .build()))) .build()); System.out.println(response); } } ``` ```go Images package main import ( "context" "log" "os" cohere "github.com/cohere-ai/cohere-go/v2" client "github.com/cohere-ai/cohere-go/v2/client" ) func main() { co := client.NewClient(client.WithToken(os.Getenv("CO_API_KEY"))) resp, err := co.V2.Chat( context.TODO(), &cohere.V2ChatRequest{ Model: "command-a-vision-07-2025", Messages: cohere.ChatMessages{ { Role: "user", User: &cohere.UserMessageV2{ Content: &cohere.UserMessageV2Content{ ContentList: []*cohere.Content{ {Type: "text", Text: &cohere.ChatTextContent{Text: "Describe this image"}}, {Type: "image_url", ImageUrl: &cohere.ImageContent{ ImageUrl: &cohere.ImageUrl{ // Can be either a base64 data URI or a web URL. Url: "https://cohere.com/favicon-32x32.png", Detail: cohere.ImageUrlDetailAuto.Ptr(), }, }}, }, }, }, }, }, }, ) if err != nil { log.Fatal(err) } log.Printf("%+v", resp) } ``` ```ruby Images require 'uri' require 'net/http' url = URI("https://api.cohere.com/v2/chat") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"stream\": false,\n \"model\": \"command-a-vision-07-2025\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": [\n {\n \"text\": \"Describe this image\",\n \"type\": \"text\"\n },\n {\n \"image_url\": {\n \"detail\": \"auto\",\n \"url\": \"https://cohere.com/favicon-32x32.png\"\n },\n \"type\": \"image_url\"\n }\n ]\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```php Images request('POST', 'https://api.cohere.com/v2/chat', [ 'body' => '{ "stream": false, "model": "command-a-vision-07-2025", "messages": [ { "role": "user", "content": [ { "text": "Describe this image", "type": "text" }, { "image_url": { "detail": "auto", "url": "https://cohere.com/favicon-32x32.png" }, "type": "image_url" } ] } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Images using RestSharp; var client = new RestClient("https://api.cohere.com/v2/chat"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"stream\": false,\n \"model\": \"command-a-vision-07-2025\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": [\n {\n \"text\": \"Describe this image\",\n \"type\": \"text\"\n },\n {\n \"image_url\": {\n \"detail\": \"auto\",\n \"url\": \"https://cohere.com/favicon-32x32.png\"\n },\n \"type\": \"image_url\"\n }\n ]\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Images import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "stream": false, "model": "command-a-vision-07-2025", "messages": [ [ "role": "user", "content": [ [ "text": "Describe this image", "type": "text" ], [ "image_url": [ "detail": "auto", "url": "https://cohere.com/favicon-32x32.png" ], "type": "image_url" ] ] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.cohere.com/v2/chat")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```