hazo_llm_api 1.0.4 → 1.0.6

package/dist/lib/providers/qwen/qwen_client.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Qwen API Client Module
+ *
+ * Handles communication with Alibaba Cloud DashScope Qwen API.
+ * Uses OpenAI-compatible chat completions endpoint.
+ */
+import type { Logger, Base64Data, LLMResponse } from '../../llm_api/types.js';
+/**
+ * Qwen generation configuration parameters
+ * Maps to OpenAI-compatible parameters
+ */
+export interface QwenGenerationConfig {
+    /** Controls randomness in output (0.0-2.0). Lower = more deterministic */
+    temperature?: number;
+    /** Maximum number of tokens in the response */
+    max_tokens?: number;
+    /** Top-p sampling (nucleus sampling) */
+    top_p?: number;
+    /** Top-k sampling */
+    top_k?: number;
+    /** Number of completion choices to generate */
+    n?: number;
+    /** Stop sequences */
+    stop?: string[];
+    /** Presence penalty */
+    presence_penalty?: number;
+    /** Frequency penalty */
+    frequency_penalty?: number;
+}
+/**
+ * Qwen API message role
+ */
+export type QwenMessageRole = 'system' | 'user' | 'assistant';
+/**
+ * Qwen API message
+ */
+export interface QwenMessage {
+    role: QwenMessageRole;
+    content: string | Array<{
+        type: 'text' | 'image_url';
+        text?: string;
+        image_url?: {
+            url: string;
+        };
+    }>;
+}
+/**
+ * Qwen API request body
+ */
+export interface QwenApiRequest {
+    model: string;
+    messages: QwenMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    top_k?: number;
+    n?: number;
+    stop?: string[];
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    result_format?: 'message' | 'text';
+    stream?: boolean;
+}
+/**
+ * Qwen API response choice
+ */
+export interface QwenChoice {
+    index: number;
+    message: {
+        role: string;
+        content: string;
+    };
+    finish_reason: string;
+}
+/**
+ * Qwen API response
+ */
+export interface QwenApiResponse {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices?: QwenChoice[];
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    error?: {
+        message: string;
+        type: string;
+        code?: string;
+    };
+}
+/**
+ * Call the Qwen API with messages and optional image data
+ * @param api_url - The Qwen API endpoint URL
+ * @param api_key - The API key for authentication
+ * @param model - The model name to use
+ * @param messages - Array of messages (system + user)
+ * @param logger - Logger instance
+ * @param generation_config - Optional generation configuration parameters
+ * @returns LLM response with generated text or error
+ */
+export declare function call_qwen_api(api_url: string, api_key: string, model: string, messages: QwenMessage[], logger: Logger, generation_config?: QwenGenerationConfig): Promise<LLMResponse>;
+/**
+ * Get the default Qwen API URL
+ * @returns The default DashScope API URL
+ */
+export declare function get_qwen_api_url(): string;
+/**
+ * Get the DashScope image generation API URL
+ * @param model - The model name (e.g., qwen-image-plus)
+ * @returns The DashScope image generation API URL
+ */
+export declare function get_qwen_image_api_url(model?: string): string;
+/**
+ * Get the DashScope image editing API URL
+ * @param model - The model name (e.g., qwen-image-edit)
+ * @returns The DashScope image editing API URL
+ */
+export declare function get_qwen_image_edit_api_url(model?: string): string;
+/**
+ * Build Qwen messages array from prompt and optional images
+ * @param prompt - The text prompt
+ * @param system_instruction - Optional system instruction
+ * @param b64_data - Optional array of base64 encoded images
+ * @returns Array of Qwen messages
+ */
+export declare function build_qwen_messages(prompt: string, system_instruction?: string, b64_data?: Base64Data[]): QwenMessage[];
+/**
+ * Call the DashScope image generation API
+ * @param api_url - The DashScope image generation API endpoint URL
+ * @param api_key - The API key for authentication
+ * @param model - The model name to use (e.g., qwen-image-plus)
+ * @param prompt - The text prompt for image generation
+ * @param logger - Logger instance
+ * @param generation_config - Optional generation configuration parameters
+ * @returns LLM response with generated image or error
+ */
+export declare function call_qwen_image_api(api_url: string, api_key: string, model: string, prompt: string, logger: Logger, generation_config?: QwenGenerationConfig): Promise<LLMResponse>;
+/**
+ * Call the DashScope image editing API
+ * @param api_url - The DashScope image editing API endpoint URL
+ * @param api_key - The API key for authentication
+ * @param model - The model name to use (e.g., qwen-image-edit)
+ * @param prompt - The text prompt describing the transformation
+ * @param input_images - Array of base64 encoded input images with mime types (1-3 images supported)
+ * @param logger - Logger instance
+ * @param generation_config - Optional generation configuration parameters
+ * @returns LLM response with edited image or error
+ */
+export declare function call_qwen_image_edit_api(api_url: string, api_key: string, model: string, prompt: string, input_images: Base64Data[], logger: Logger, generation_config?: QwenGenerationConfig): Promise<LLMResponse>;
+//# sourceMappingURL=qwen_client.d.ts.map

package/dist/lib/providers/qwen/qwen_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen_client.d.ts","sourceRoot":"","sources":["../../../../src/lib/providers/qwen/qwen_client.ts"],"names":[],"mappings":"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"}