gopenrouter

type ChatCompletionChoiceLogprobs struct {
	Content []ChatCompletionTokenLogprob `json:"content,omitempty"`
	Refusal []ChatCompletionTokenLogprob `json:"refusal,omitempty"`
}

type ChatCompletionMessage struct {
	Role         ChatCompletionMessageRole   `json:"role"`
	Content      string                      `json:"content,omitempty"`
	MultiContent []ChatCompletionMessagePart `json:"-"`

	Name       string     `json:"name,omitempty"`
	ToolCalls  []ToolCall `json:"tool_calls,omitempty"`
	ToolCallID string     `json:"tool_call_id,omitempty"`
	Refusal    string     `json:"refusal,omitempty"`

	Reasoning        string            `json:"reasoning,omitempty"`
	ReasoningDetails []ReasoningDetail `json:"reasoning_details,omitempty"`
	Images           []GeneratedImage  `json:"images,omitempty"`
}

type ChatCompletionMessagePart struct {
	Type         string        `json:"type"`
	Text         string        `json:"text,omitempty"`
	ImageURL     *ImageURL     `json:"image_url,omitempty"`
	File         *File         `json:"file,omitempty"`
	InputAudio   *InputAudio   `json:"input_audio,omitempty"`
	VideoURL     *VideoInput   `json:"video_url,omitempty"`
	CacheControl *CacheControl `json:"cache_control,omitempty"`
}

type ChatCompletionMessageRole string

type ChatCompletionRequest struct {
	Model         string                  `json:"model,omitempty"`
	Messages      []ChatCompletionMessage `json:"messages,omitempty"`
	Temperature   float64                 `json:"temperature,omitempty"`
	TopP          float64                 `json:"top_p,omitempty"`
	N             int                     `json:"n,omitempty"`
	Stream        bool                    `json:"stream,omitempty"`
	StreamOptions *StreamOptions          `json:"stream_options,omitempty"`
	Stop          []string                `json:"stop,omitempty"`
	// Deprecated: use MaxCompletionTokens instead.
	MaxTokens           int             `json:"max_tokens,omitempty"`
	MaxCompletionTokens *int            `json:"max_completion_tokens,omitempty"`
	PresencePenalty     float64         `json:"presence_penalty,omitempty"`
	FrequencyPenalty    float64         `json:"frequency_penalty,omitempty"`
	LogitBias           map[string]int  `json:"logit_bias,omitempty"`
	User                string          `json:"user,omitempty"`
	Seed                *int            `json:"seed,omitempty"`
	Tools               []Tool          `json:"tools,omitempty"`
	ToolChoice          any             `json:"tool_choice,omitempty"`
	LogProbs            *bool           `json:"logprobs,omitempty"`
	ResponseFormat      *ResponseFormat `json:"response_format,omitempty"`
	TopK                *float64        `json:"top_k,omitempty"`
	RepetitionPenalty   *float64        `json:"repetition_penalty,omitempty"`
	TopLogProbs         *int            `json:"top_logprobs,omitempty"`
	MinP                *float64        `json:"min_p,omitempty"`
	TopA                *float64        `json:"top_a,omitempty"`
	Prediction          *Prediction     `json:"prediction,omitempty"`

	Models []string `json:"models,omitempty"`
	// Deprecated: use Provider.Sort.Config.Partition instead.
	Route             string               `json:"route,omitempty"`
	Transforms        []string             `json:"transforms,omitempty"`
	Reasoning         *ReasoningParams     `json:"reasoning,omitempty"`
	Usage             *UsageParams         `json:"usage,omitempty"`
	ExtraBody         map[string]any       `json:"-"`
	Plugins           []Plugin             `json:"plugins,omitempty"`
	ParallelToolCalls *bool                `json:"parallel_tool_calls,omitempty"`
	Provider          *ProviderPreferences `json:"provider,omitempty"`
	Metadata          map[string]string    `json:"metadata,omitempty"`
	Modalities        []string             `json:"modalities,omitempty"`
	ImageConfig       map[string]any       `json:"image_config,omitempty"`
	SessionID         string               `json:"session_id,omitempty"`
	Trace             *TraceMetadata       `json:"trace,omitempty"`
	Debug             *DebugOptions        `json:"debug,omitempty"`
}

type ChatCompletionResponse struct {
	ID                string   `json:"id"`
	Object            string   `json:"object"`
	Created           int64    `json:"created"`
	Model             string   `json:"model"`
	Choices           []Choice `json:"choices"`
	Usage             Usage    `json:"usage"`
	SystemFingerprint string   `json:"system_fingerprint,omitempty"`
}

type ChatCompletionStream struct {
	*StreamReader
}

type ChatCompletionStreamChoice struct {
	Index              int                                 `json:"index"`
	Delta              ChatCompletionMessage               `json:"delta"`
	FinishReason       string                              `json:"finish_reason"`
	NativeFinishReason string                              `json:"native_finish_reason,omitempty"`
	Logprobs           *ChatCompletionStreamChoiceLogprobs `json:"logprobs,omitempty"`
}

type ChatCompletionStreamChoiceDelta struct {
	Token   string  `json:"token"`
	LogProb float64 `json:"logprob"`
	Bytes   []byte  `json:"bytes,omitempty"`
}

type ChatCompletionStreamChoiceLogprobs struct {
	Content []ChatCompletionStreamChoiceDelta `json:"content,omitempty"`
	Refusal []ChatCompletionStreamChoiceDelta `json:"refusal,omitempty"`
}

type ChatCompletionStreamResponse struct {
	ID                string                       `json:"id"`
	Object            string                       `json:"object"`
	Created           int64                        `json:"created"`
	Model             string                       `json:"model"`
	Choices           []ChatCompletionStreamChoice `json:"choices"`
	SystemFingerprint string                       `json:"system_fingerprint,omitempty"`
	Usage             *Usage                       `json:"usage,omitempty"`
	Error             *APIError                    `json:"error,omitempty"`
}

type ChatCompletionTokenLogprob struct {
	Token       string                                 `json:"token"`
	LogProb     float64                                `json:"logprob"`
	Bytes       []byte                                 `json:"bytes,omitempty"`
	TopLogProbs []ChatCompletionTokenLogprobTopLogprob `json:"top_logprobs,omitempty"`
}

type ChatCompletionTokenLogprobTopLogprob struct {
	Token   string  `json:"token"`
	LogProb float64 `json:"logprob"`
	Bytes   []byte  `json:"bytes,omitempty"`
}

type Choice struct {
	Index              int                           `json:"index"`
	Message            ChatCompletionMessage         `json:"message"`
	FinishReason       string                        `json:"finish_reason"`
	NativeFinishReason string                        `json:"native_finish_reason,omitempty"`
	Logprobs           *ChatCompletionChoiceLogprobs `json:"logprobs,omitempty"`
}

type Client struct {
	*official.OpenRouter
	// contains filtered or unexported fields
}

type ClientConfig struct {
	AuthToken string
	BaseURL   string
	// Deprecated: this field is kept only for backward compatibility and is not sent, because the current public OpenRouter API does not define an organization header.
	OrgID          string
	HTTPClient     *http.Client
	SiteURL        string
	SiteName       string
	SiteCategories []string

	// Deprecated: use AuthToken instead.
	APIKey string
}

type CostDetails struct {
	UpstreamInferenceCost       float64 `json:"upstream_inference_cost,omitempty"`
	UpstreamInferenceInputCost  float64 `json:"upstream_inference_input_cost,omitempty"`
	UpstreamInferenceOutputCost float64 `json:"upstream_inference_output_cost,omitempty"`
}

type Function struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Parameters  any    `json:"parameters,omitempty"`
	Arguments   string `json:"arguments,omitempty"`
}

type Generation struct {
	ID                          string                       `json:"id"`
	UpstreamID                  string                       `json:"upstream_id,omitempty"`
	TotalCost                   float64                      `json:"total_cost,omitempty"`
	CacheDiscount               float64                      `json:"cache_discount,omitempty"`
	UpstreamInferenceCost       float64                      `json:"upstream_inference_cost,omitempty"`
	CreatedAt                   string                       `json:"created_at,omitempty"`
	Model                       string                       `json:"model,omitempty"`
	AppID                       int                          `json:"app_id,omitempty"`
	Streamed                    *bool                        `json:"streamed,omitempty"`
	Cancelled                   *bool                        `json:"cancelled,omitempty"`
	ProviderName                string                       `json:"provider_name,omitempty"`
	Latency                     *float64                     `json:"latency,omitempty"`
	ModerationLatency           *float64                     `json:"moderation_latency,omitempty"`
	GenerationTime              *float64                     `json:"generation_time,omitempty"`
	FinishReason                string                       `json:"finish_reason,omitempty"`
	NativeFinishReason          string                       `json:"native_finish_reason,omitempty"`
	PromptTokens                int                          `json:"tokens_prompt,omitempty"`
	CompletionTokens            int                          `json:"tokens_completion,omitempty"`
	NativePromptTokens          int                          `json:"native_tokens_prompt,omitempty"`
	NativeCompletionTokens      int                          `json:"native_tokens_completion,omitempty"`
	NativeCompletionImageTokens int                          `json:"native_tokens_completion_images,omitempty"`
	NativeReasoningTokens       int                          `json:"native_tokens_reasoning,omitempty"`
	NativeCachedTokens          int                          `json:"native_tokens_cached,omitempty"`
	NumMediaPrompt              int                          `json:"num_media_prompt,omitempty"`
	NumInputAudioPrompt         int                          `json:"num_input_audio_prompt,omitempty"`
	NumMediaCompletion          int                          `json:"num_media_completion,omitempty"`
	NumSearchResults            int                          `json:"num_search_results,omitempty"`
	Origin                      string                       `json:"origin,omitempty"`
	Usage                       float64                      `json:"usage,omitempty"`
	IsBYOK                      bool                         `json:"is_byok,omitempty"`
	ExternalUser                string                       `json:"external_user,omitempty"`
	APIType                     string                       `json:"api_type,omitempty"`
	Router                      string                       `json:"router,omitempty"`
	ProviderResponses           []GenerationProviderResponse `json:"provider_responses,omitempty"`
}

type GenerationProviderResponse struct {
	ID             string   `json:"id,omitempty"`
	EndpointID     string   `json:"endpoint_id,omitempty"`
	ModelPermaslug string   `json:"model_permaslug,omitempty"`
	ProviderName   string   `json:"provider_name,omitempty"`
	Status         *int     `json:"status,omitempty"`
	Latency        *float64 `json:"latency,omitempty"`
	IsBYOK         *bool    `json:"is_byok,omitempty"`
}

type GenerationResponse struct {
	Data Generation `json:"data"`
}

type Prediction struct {
	Type    string `json:"type"`
	Content string `json:"content"`
}

type ReasoningDetail struct {
	Type      string `json:"type"`
	Summary   string `json:"summary,omitempty"`
	Data      string `json:"data,omitempty"`
	Text      string `json:"text,omitempty"`
	Signature string `json:"signature,omitempty"`
	ID        string `json:"id,omitempty"`
	Format    string `json:"format,omitempty"`
	Index     *int   `json:"index,omitempty"`

	Encrypted string `json:"-"`
}

type ReasoningEffort string

type ReasoningParams struct {
	Effort  ReasoningEffort           `json:"effort,omitempty"`
	Summary ReasoningSummaryVerbosity `json:"summary,omitempty"`
	// Deprecated: retained only as a legacy compatibility field.
	Exclude bool `json:"exclude,omitempty"`
	// Deprecated: retained only as a legacy compatibility field.
	MaxTokens int `json:"max_tokens,omitempty"`
}

type ReasoningSummaryVerbosity string

type SSEEvent struct {
	Event string
	Data  []byte
}

type SSEReader struct {
	// contains filtered or unexported fields
}

type ServerToolUse struct {
	WebSearchRequests int `json:"web_search_requests,omitempty"`
}

type StreamOptions struct {
	IncludeUsage bool `json:"include_usage,omitempty"`
}

type StreamReader struct {
	// contains filtered or unexported fields
}

type TokensDetails struct {
	CachedTokens             int `json:"cached_tokens,omitempty"`
	CacheWriteTokens         int `json:"cache_write_tokens,omitempty"`
	ReasoningTokens          int `json:"reasoning_tokens,omitempty"`
	AudioTokens              int `json:"audio_tokens,omitempty"`
	VideoTokens              int `json:"video_tokens,omitempty"`
	AcceptedPredictionTokens int `json:"accepted_prediction_tokens,omitempty"`
	RejectedPredictionTokens int `json:"rejected_prediction_tokens,omitempty"`
}

type Tool struct {
	Type     string   `json:"type"`
	Function Function `json:"function"`
}

type ToolCall struct {
	Index    int      `json:"index,omitempty"`
	ID       string   `json:"id,omitempty"`
	Type     string   `json:"type,omitempty"`
	Function Function `json:"function"`
}

type Usage struct {
	PromptTokens            int            `json:"prompt_tokens"`
	CompletionTokens        int            `json:"completion_tokens"`
	TotalTokens             int            `json:"total_tokens"`
	Cost                    float64        `json:"cost,omitempty"`
	IsBYOK                  *bool          `json:"is_byok,omitempty"`
	ImageTokens             int            `json:"image_tokens,omitempty"`
	CostDetails             *CostDetails   `json:"cost_details,omitempty"`
	ServerToolUse           *ServerToolUse `json:"server_tool_use,omitempty"`
	PromptTokensDetails     *TokensDetails `json:"prompt_tokens_details,omitempty"`
	CompletionTokensDetails *TokensDetails `json:"completion_tokens_details,omitempty"`
}

type UsageParams struct {
	Include bool `json:"include"`
}