chat_completions

Creates, updates, deletes, gets or lists a chat_completions resource.

Overview

Name	chat_completions
Type	Resource
Id	cloudflare.aisearch.chat_completions

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
chat_completions_by_account	insert	id, account_id, messages		Performs a chat completion request against an AI Search instance, using indexed content as context for generating responses.
chat_completions	insert	account_id, name, messages, ai_search_options		Performs a chat completion request against multiple AI Search instances in parallel, merging retrieved content as context for generating a response.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
id	string	Resource ID.
name	string	Resource name.

INSERT examples

chat_completions_by_account

Performs a chat completion request against an AI Search instance, using indexed content as context for generating responses.

INSERT INTO cloudflare.aisearch.chat_completions (
ai_search_options,
messages,
model,
stream,
id,
account_id
)
SELECT 
'{{ ai_search_options }}',
'{{ messages }}' /* required */,
'{{ model }}',
{{ stream }},
'{{ id }}',
'{{ account_id }}'
RETURNING
id,
choices,
chunks,
model,
object
;

chat_completions

Performs a chat completion request against multiple AI Search instances in parallel, merging retrieved content as context for generating a response.

INSERT INTO cloudflare.aisearch.chat_completions (
ai_search_options,
messages,
model,
stream,
account_id,
name
)
SELECT 
'{{ ai_search_options }}' /* required */,
'{{ messages }}' /* required */,
'{{ model }}',
{{ stream }},
'{{ account_id }}',
'{{ name }}'
RETURNING
id,
choices,
chunks,
errors,
model,
object
;

Manifest

# Description fields are for documentation purposes
- name: chat_completions
props:
  - name: id
    value: "{{ id }}"
    description: Required parameter for the chat_completions resource.
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the chat_completions resource.
  - name: name
    value: "{{ name }}"
    description: Required parameter for the chat_completions resource.
  - name: ai_search_options
    value:
      cache:
        cache_threshold: "{{ cache_threshold }}"
        enabled: {{ enabled }}
      instance_ids:
        - "{{ instance_ids }}"
      query_rewrite:
        enabled: {{ enabled }}
        model: "{{ model }}"
        rewrite_prompt: "{{ rewrite_prompt }}"
      reranking:
        enabled: {{ enabled }}
        match_threshold: {{ match_threshold }}
        model: "{{ model }}"
      retrieval:
        boost_by:
          - direction: "{{ direction }}"
            field: "{{ field }}"
        context_expansion: {{ context_expansion }}
        filters: "{{ filters }}"
        fusion_method: "{{ fusion_method }}"
        keyword_match_mode: "{{ keyword_match_mode }}"
        match_threshold: {{ match_threshold }}
        max_num_results: {{ max_num_results }}
        retrieval_type: "{{ retrieval_type }}"
        return_on_failure: {{ return_on_failure }}
  - name: messages
    value:
      - content: "{{ content }}"
        role: "{{ role }}"
  - name: model
    value: "{{ model }}"
    valid_values: ['@cf/meta/llama-3.3-70b-instruct-fp8-fast', '@cf/zai-org/glm-4.7-flash', '@cf/meta/llama-3.1-8b-instruct-fast', '@cf/meta/llama-3.1-8b-instruct-fp8', '@cf/meta/llama-4-scout-17b-16e-instruct', '@cf/qwen/qwen3-30b-a3b-fp8', '@cf/deepseek-ai/deepseek-r1-distill-qwen-32b', '@cf/moonshotai/kimi-k2-instruct', '@cf/google/gemma-3-12b-it', '@cf/google/gemma-4-26b-a4b-it', '@cf/moonshotai/kimi-k2.5', 'anthropic/claude-3-7-sonnet', 'anthropic/claude-sonnet-4', 'anthropic/claude-opus-4', 'anthropic/claude-3-5-haiku', 'cerebras/qwen-3-235b-a22b-instruct', 'cerebras/qwen-3-235b-a22b-thinking', 'cerebras/llama-3.3-70b', 'cerebras/llama-4-maverick-17b-128e-instruct', 'cerebras/llama-4-scout-17b-16e-instruct', 'cerebras/gpt-oss-120b', 'google-ai-studio/gemini-2.5-flash', 'google-ai-studio/gemini-2.5-pro', 'grok/grok-4', 'groq/llama-3.3-70b-versatile', 'groq/llama-3.1-8b-instant', 'openai/gpt-5', 'openai/gpt-5-mini', 'openai/gpt-5-nano']
  - name: stream
    value: {{ stream }}