coze-coding-dev-sdk 0.4.2__tar.gz → 0.4.4__tar.gz

{coze_coding_dev_sdk-0.4.2/coze_coding_dev_sdk.egg-info → coze_coding_dev_sdk-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coze-coding-dev-sdk
-Version: 0.4.2
+Version: 0.4.4
 Summary: Coze Coding Dev SDK - 优雅的多功能 AI SDK，支持图片生成、视频生成、语音合成、语音识别、大语言模型和联网搜索。包含命令行工具 coze-coding-ai，支持 Context 上下文追踪
 Author-email: Coze Coding Integration Team <support@coze.com>
 Maintainer-email: Coze Coding Integration Team <support@coze.com>

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/__init__.py

@@ -44,7 +44,7 @@ from .video import (
     VideoGenerationTask
 )
 
-__version__ = "0.2.0"
+__version__ = "0.4.4"
 
 __all__ = [
     "Config",

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/cli/chat.py

@@ -22,17 +22,29 @@ console = Console()
     "--output", "-o", type=click.Path(), help="Output file path (JSON format)"
 )
 @click.option("--stream", is_flag=True, help="Stream the response in real-time")
+@click.option(
+    "--header",
+    "-H",
+    multiple=True,
+    help="自定义 HTTP 请求头 (格式: 'Key: Value' 或 'Key=Value'，可多次使用)",
+)
+@click.option("--verbose", "-v", is_flag=True, help="显示详细的 HTTP 请求日志")
 def chat(
     prompt: str,
     system: Optional[str],
     thinking: bool,
     output: Optional[str],
     stream: bool,
+    header: tuple,
+    verbose: bool,
 ):
     """Chat with AI using natural language."""
     try:
+        from .utils import parse_headers
+
         config = Config()
-        client = LLMClient(config)
+        custom_headers = parse_headers(header)
+        client = LLMClient(config, custom_headers=custom_headers, verbose=verbose)
 
         messages = []
         if system:

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/cli/image.py

@@ -4,7 +4,7 @@ import time
 from typing import Optional
 
 import click
-from coze_coding_utils.runtime_ctx.context import Context
+from coze_coding_utils.runtime_ctx.context import new_context
 from rich.console import Console
 
 from ..core.config import Config
@@ -56,22 +56,40 @@ def validate_and_normalize_size(size: str) -> str:
     help="Multiple reference image URLs or paths (can be used multiple times)",
 )
 @click.option("--mock", is_flag=True, help="使用 mock 模式（测试运行）")
+@click.option(
+    "--header",
+    "-H",
+    multiple=True,
+    help="自定义 HTTP 请求头 (格式: 'Key: Value' 或 'Key=Value'，可多次使用)",
+)
+@click.option("--verbose", "-v", is_flag=True, help="显示详细的 HTTP 请求日志")
 def image(
-    prompt: str, output: str, size: str, image: Optional[str], images: tuple, mock: bool
+    prompt: str,
+    output: str,
+    size: str,
+    image: Optional[str],
+    images: tuple,
+    mock: bool,
+    header: tuple,
+    verbose: bool,
 ):
     """Generate image using AI."""
     try:
+        from .utils import parse_headers
+
         config = Config()
 
         ctx = None
+        custom_headers = parse_headers(header)
+
         if mock:
-            ctx = Context(
-                request_id=f"mock-req-{int(time.time())}",
-                headers={RUN_MODE_HEADER: RUN_MODE_TEST},
-            )
+            ctx = new_context(method="image.generate", headers=custom_headers)
+            custom_headers[RUN_MODE_HEADER] = RUN_MODE_TEST
             console.print("[yellow]🧪 Mock 模式已启用（测试运行）[/yellow]")
 
-        client = ImageGenerationClient(config, ctx=ctx)
+        client = ImageGenerationClient(
+            config, ctx=ctx, custom_headers=custom_headers, verbose=verbose
+        )
 
         reference_images = None
         if image:

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/cli/search.py

@@ -121,7 +121,14 @@ def save_to_json(response, output_path: str):
 @click.option("--time-range", help="发文时间范围,如: 1d, 1w, 1m (仅 web 类型)")
 @click.option("--output", "-o", type=click.Path(), help="输出 JSON 文件路径")
 @click.option("--format", "-f", type=click.Choice(["table", "json", "simple"]), default="table", help="输出格式")
-def search(query, type, count, summary, need_content, need_url, sites, block_hosts, time_range, output, format):
+@click.option(
+    "--header",
+    "-H",
+    multiple=True,
+    help="自定义 HTTP 请求头 (格式: 'Key: Value' 或 'Key=Value'，可多次使用)",
+)
+@click.option("--verbose", "-v", is_flag=True, help="显示详细的 HTTP 请求日志")
+def search(query, type, count, summary, need_content, need_url, sites, block_hosts, time_range, output, format, header, verbose):
     """联网搜索
 
     支持三种搜索类型:
@@ -147,8 +154,11 @@ def search(query, type, count, summary, need_content, need_url, sites, block_hos
         coze-coding-ai search "新闻" --time-range "1d" --need-url
     """
     try:
+        from .utils import parse_headers
+
         config = Config()
-        client = SearchClient(config)
+        custom_headers = parse_headers(header)
+        client = SearchClient(config, custom_headers=custom_headers, verbose=verbose)
         
         if type == "image":
             console.print(f"[bold magenta]正在搜索图片:[/bold magenta] {query}")

coze_coding_dev_sdk-0.4.4/coze_coding_dev_sdk/cli/utils.py

@@ -0,0 +1,41 @@
+from typing import Dict, Optional, Tuple
+
+
+def parse_headers(header_strings: Tuple[str, ...]) -> Optional[Dict[str, str]]:
+    """
+    解析命令行传入的 header 字符串
+    
+    支持格式:
+    - "Key: Value"
+    - "Key=Value"
+    
+    示例:
+        --header "X-Custom: value1" --header "X-Test=value2"
+    
+    Args:
+        header_strings: 命令行传入的 header 字符串元组
+    
+    Returns:
+        Dict[str, str] or None: 解析后的 headers 字典，如果没有则返回 None
+    
+    Raises:
+        ValueError: 如果 header 格式不正确
+    """
+    if not header_strings:
+        return None
+    
+    headers = {}
+    for header_str in header_strings:
+        if ": " in header_str:
+            key, value = header_str.split(": ", 1)
+        elif "=" in header_str:
+            key, value = header_str.split("=", 1)
+        else:
+            raise ValueError(
+                f"Invalid header format: '{header_str}'. "
+                f"Use 'Key: Value' or 'Key=Value'"
+            )
+        
+        headers[key.strip()] = value.strip()
+    
+    return headers if headers else None

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/cli/video.py

@@ -4,7 +4,7 @@ import time
 from typing import Optional
 
 import click
-from coze_coding_utils.runtime_ctx.context import Context
+from coze_coding_utils.runtime_ctx.context import new_context
 from rich.console import Console
 from rich.progress import Progress, SpinnerColumn, TextColumn
 from rich.table import Table
@@ -54,6 +54,13 @@ def parse_resolution(size: Optional[str]) -> tuple[Optional[str], Optional[str]]
 @click.option("--max-polls", type=int, default=60, help="Maximum poll attempts")
 @click.option("--output", "-o", type=click.Path(), help="Output file path (JSON)")
 @click.option("--mock", is_flag=True, help="使用 mock 模式（测试运行）")
+@click.option(
+    "--header",
+    "-H",
+    multiple=True,
+    help="自定义 HTTP 请求头 (格式: 'Key: Value' 或 'Key=Value'，可多次使用)",
+)
+@click.option("--verbose", "-v", is_flag=True, help="显示详细的 HTTP 请求日志")
 def video(
     prompt: Optional[str],
     image_url: Optional[str],
@@ -68,20 +75,24 @@ def video(
     max_polls: int,
     output: Optional[str],
     mock: bool,
+    header: tuple,
+    verbose: bool,
 ):
     """Generate video using AI."""
     try:
+        from .utils import parse_headers
+
         config = Config()
 
         ctx = None
+        custom_headers = parse_headers(header)
+        
         if mock:
-            ctx = Context(
-                request_id=f"mock-req-{int(time.time())}",
-                headers={RUN_MODE_HEADER: RUN_MODE_TEST},
-            )
+            ctx = new_context(method="video.generate", headers=custom_headers)
+            custom_headers[RUN_MODE_HEADER] = RUN_MODE_TEST
             console.print("[yellow]🧪 Mock 模式已启用（测试运行）[/yellow]")
 
-        client = VideoGenerationClient(config, ctx=ctx)
+        client = VideoGenerationClient(config, ctx=ctx, custom_headers=custom_headers, verbose=verbose)
 
         image_urls = None
         if image_url:
@@ -203,20 +214,22 @@ def video(
 @click.argument("task_id")
 @click.option("--output", "-o", type=click.Path(), help="Output file path (JSON)")
 @click.option("--mock", is_flag=True, help="使用 mock 模式（测试运行）")
-def video_status(task_id: str, output: Optional[str], mock: bool):
+@click.option("--verbose", "-v", is_flag=True, help="显示详细的 HTTP 请求日志")
+def video_status(task_id: str, output: Optional[str], mock: bool, verbose: bool):
     """Check video generation task status."""
     try:
         config = Config()
 
         ctx = None
         if mock:
-            ctx = Context(
-                request_id=f"mock-req-{int(time.time())}",
-                headers={RUN_MODE_HEADER: RUN_MODE_TEST},
-            )
+            ctx = new_context(method="video.status")
             console.print("[yellow]🧪 Mock 模式已启用（测试运行）[/yellow]")
 
-        client = VideoGenerationClient(config, ctx=ctx)
+        custom_headers = {}
+        if mock:
+            custom_headers[RUN_MODE_HEADER] = RUN_MODE_TEST
+            
+        client = VideoGenerationClient(config, ctx=ctx, custom_headers=custom_headers, verbose=verbose)
 
         task_result = client._get_task_status(task_id)
         result = task_result.model_dump()

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/cli/voice.py

@@ -5,7 +5,7 @@ import time
 from typing import Optional
 
 import click
-from coze_coding_utils.runtime_ctx.context import Context
+from coze_coding_utils.runtime_ctx.context import new_context
 from rich.console import Console
 from rich.panel import Panel
 from rich.progress import Progress, SpinnerColumn, TextColumn
@@ -63,6 +63,13 @@ COMMON_SPEAKERS = {
 @click.option("--loudness-rate", type=int, default=0, help="音量 (-50 到 100)")
 @click.option("--ssml", is_flag=True, help="使用 SSML 格式")
 @click.option("--mock", is_flag=True, help="使用 mock 模式（测试运行）")
+@click.option(
+    "--header",
+    "-H",
+    multiple=True,
+    help="自定义 HTTP 请求头 (格式: 'Key: Value' 或 'Key=Value'，可多次使用)",
+)
+@click.option("--verbose", "-v", is_flag=True, help="显示详细的 HTTP 请求日志")
 def tts(
     text,
     output,
@@ -74,6 +81,8 @@ def tts(
     loudness_rate,
     ssml,
     mock,
+    header,
+    verbose,
 ):
     """语音合成 (Text-to-Speech)
 
@@ -111,17 +120,19 @@ def tts(
       coze-coding-ai tts "儿童故事" -o story.mp3 -s zh_female_xueayi_saturn_bigtts --speech-rate 20
     """
     try:
+        from .utils import parse_headers
+
         config = Config()
 
         ctx = None
+        custom_headers = parse_headers(header)
+        
         if mock:
-            ctx = Context(
-                request_id=f"mock-req-{int(time.time())}",
-                headers={RUN_MODE_HEADER: RUN_MODE_TEST},
-            )
+            ctx = new_context(method="tts.generate", headers=custom_headers)
+            custom_headers[RUN_MODE_HEADER] = RUN_MODE_TEST
             console.print("[yellow]🧪 Mock 模式已启用（测试运行）[/yellow]")
 
-        client = TTSClient(config, ctx=ctx)
+        client = TTSClient(config, ctx=ctx, custom_headers=custom_headers, verbose=verbose)
 
         with Progress(
             SpinnerColumn(),
@@ -216,7 +227,14 @@ def tts(
 )
 @click.option("--base64", is_flag=True, help="将本地文件转为 base64 上传")
 @click.option("--mock", is_flag=True, help="使用 mock 模式（测试运行）")
-def asr(audio, uid, output, format, base64, mock):
+@click.option(
+    "--header",
+    "-H",
+    multiple=True,
+    help="自定义 HTTP 请求头 (格式: 'Key: Value' 或 'Key=Value'，可多次使用)",
+)
+@click.option("--verbose", "-v", is_flag=True, help="显示详细的 HTTP 请求日志")
+def asr(audio, uid, output, format, base64, mock, header, verbose):
     """语音识别 (Automatic Speech Recognition)
 
     将语音音频转换为文本。
@@ -231,20 +249,22 @@ def asr(audio, uid, output, format, base64, mock):
       coze-coding-ai asr https://example.com/audio.mp3
       coze-coding-ai asr ./audio.mp3 -o result.txt
       coze-coding-ai asr ./audio.mp3 -f json
-      coze-coding-ai asr ./audio.mp3 --base64
+      coze-coding-ai asr audio.mp3 --base64 --output result.txt
     """
     try:
+        from .utils import parse_headers
+
         config = Config()
 
         ctx = None
+        custom_headers = parse_headers(header)
+        
         if mock:
-            ctx = Context(
-                request_id=f"mock-req-{int(time.time())}",
-                headers={RUN_MODE_HEADER: RUN_MODE_TEST},
-            )
+            ctx = new_context(method="asr.recognize", headers=custom_headers)
+            custom_headers[RUN_MODE_HEADER] = RUN_MODE_TEST
             console.print("[yellow]🧪 Mock 模式已启用（测试运行）[/yellow]")
 
-        client = ASRClient(config, ctx=ctx)
+        client = ASRClient(config, ctx=ctx, custom_headers=custom_headers, verbose=verbose)
 
         audio_url = None
         audio_base64 = None

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/core/__init__.py

@@ -8,6 +8,11 @@ from .exceptions import (
     ValidationError
 )
 
+try:
+    from .. import __version__
+except ImportError:
+    __version__ = "0.0.0"
+
 __all__ = [
     "BaseClient",
     "Config",
@@ -16,4 +21,5 @@ __all__ = [
     "APIError",
     "NetworkError",
     "ValidationError",
+    "__version__",
 ]

coze_coding_dev_sdk-0.4.4/coze_coding_dev_sdk/core/client.py

@@ -0,0 +1,188 @@
+import json
+import time
+from typing import Dict, Optional
+
+import requests
+from coze_coding_utils.runtime_ctx.context import Context, default_headers
+from rich.console import Console
+from rich.panel import Panel
+from rich.syntax import Syntax
+
+from .config import Config
+from .exceptions import APIError, NetworkError
+
+console = Console()
+
+
+class BaseClient:
+    def __init__(
+        self,
+        config: Optional[Config] = None,
+        ctx: Optional[Context] = None,
+        custom_headers: Optional[Dict[str, str]] = None,
+        verbose: bool = False,
+    ):
+        if config is None:
+            config = Config()
+        self.config = config
+        self.ctx = ctx
+        self.custom_headers = custom_headers or {}
+        self.verbose = verbose
+
+    def _request(
+        self, method: str, url: str, headers: Optional[Dict[str, str]] = None, **kwargs
+    ) -> dict:
+        request_headers = {}
+
+        if self.ctx is not None:
+            ctx_headers = default_headers(self.ctx)
+            request_headers.update(ctx_headers)
+
+        if self.custom_headers:
+            request_headers.update(self.custom_headers)
+
+        config_headers = self.config.get_headers(headers)
+        request_headers.update(config_headers)
+
+        response = self._make_request(
+            method=method, url=url, headers=request_headers, **kwargs
+        )
+        return self._handle_response(response)
+
+    def _sanitize_headers(self, headers: Dict[str, str]) -> Dict[str, str]:
+        sanitized = headers.copy()
+        if "Authorization" in sanitized:
+            token = sanitized["Authorization"]
+            if token.startswith("Bearer "):
+                token = token[7:]
+                if len(token) > 16:
+                    sanitized["Authorization"] = f"Bearer {token[:8]}...{token[-4:]}"
+                else:
+                    sanitized["Authorization"] = "Bearer ****"
+        return sanitized
+
+    def _log_request(self, method: str, url: str, **kwargs):
+        if not self.verbose:
+            return
+
+        parts = []
+        parts.append(f"[bold cyan]{method}[/bold cyan] {url}\n")
+
+        headers = kwargs.get("headers", {})
+        sanitized_headers = self._sanitize_headers(headers)
+        if sanitized_headers:
+            parts.append("[bold]Headers:[/bold]")
+            for key, value in sanitized_headers.items():
+                parts.append(f"  {key}: {value}")
+            parts.append("")
+
+        if "json" in kwargs and kwargs["json"]:
+            parts.append("[bold]Body:[/bold]")
+            try:
+                json_str = json.dumps(kwargs["json"], ensure_ascii=False, indent=2)
+                parts.append("")
+            except Exception:
+                json_str = str(kwargs["json"])
+                parts.append("")
+
+        content = "\n".join(parts)
+        console.print(
+            Panel(
+                content,
+                title="[bold green]HTTP Request[/bold green]",
+                border_style="green",
+            )
+        )
+
+        if "json" in kwargs and kwargs["json"]:
+            try:
+                json_str = json.dumps(kwargs["json"], ensure_ascii=False, indent=2)
+                console.print(
+                    Syntax(json_str, "json", theme="monokai", line_numbers=False)
+                )
+                console.print()
+            except Exception:
+                pass
+
+    def _log_response(self, response: requests.Response):
+        if not self.verbose:
+            return
+
+        parts = []
+        parts.append(f"[bold]Status:[/bold] {response.status_code} {response.reason}\n")
+        parts.append("[bold]Body:[/bold]")
+
+        content = "\n".join(parts)
+        console.print(
+            Panel(
+                content,
+                title="[bold blue]HTTP Response[/bold blue]",
+                border_style="blue",
+            )
+        )
+
+        try:
+            response_data = response.json()
+            json_str = json.dumps(response_data, ensure_ascii=False, indent=2)
+            if len(json_str) > 2000:
+                json_str = json_str[:2000] + "\n... (truncated)"
+            console.print(Syntax(json_str, "json", theme="monokai", line_numbers=False))
+        except Exception:
+            body_text = response.text[:500]
+            if len(response.text) > 500:
+                body_text += "... (truncated)"
+            console.print(f"  {body_text}")
+
+        console.print()
+
+    def _make_request(self, method: str, url: str, **kwargs) -> requests.Response:
+        last_error = None
+
+        for attempt in range(self.config.retry_times):
+            try:
+                if attempt == 0:
+                    self._log_request(method, url, **kwargs)
+
+                response = requests.request(
+                    method=method, url=url, timeout=self.config.timeout, **kwargs
+                )
+
+                if attempt == 0:
+                    self._log_response(response)
+
+                return response
+
+            except requests.exceptions.RequestException as e:
+                last_error = NetworkError(str(e), e)
+                if attempt < self.config.retry_times - 1:
+                    time.sleep(self.config.retry_delay * (attempt + 1))
+                    continue
+
+        raise last_error
+
+    def _handle_response(self, response: requests.Response) -> dict:
+        try:
+            data = response.json()
+        except Exception as e:
+            raise APIError(
+                f"响应解析失败: {str(e)}, 响应内容: {response.text[:200]}",
+                status_code=response.status_code,
+            )
+
+        try:
+            response.raise_for_status()
+        except requests.exceptions.HTTPError as e:
+            error_msg = f"HTTP 错误: {str(e)}"
+            if data:
+                error_msg += f", 响应数据: {data}"
+            raise APIError(
+                error_msg, status_code=response.status_code, response_data=data
+            )
+
+        return data
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        pass

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/core/config.py

@@ -42,9 +42,15 @@ class Config:
             raise ConfigurationError("Base URL 未配置")
     
     def get_headers(self, ctx_headers: Optional[dict] = None) -> dict:
+        try:
+            from .. import __version__
+        except ImportError:
+            __version__ = "0.0.0"
+        
         headers = {}
         if ctx_headers:
             headers.update(ctx_headers)
         headers.setdefault("Content-Type", "application/json")
         headers.setdefault("Authorization", f"Bearer {self.api_key}")
+        headers.setdefault("X-Client-Sdk", f"coze-coding-dev-sdk-python/{__version__}")
         return headers

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/image/client.py

@@ -16,12 +16,13 @@ class ImageGenerationClient(BaseClient):
         config: Optional[Config] = None,
         ctx: Optional[Context] = None,
         custom_headers: Optional[Dict[str, str]] = None,
+        verbose: bool = False,
     ):
-        super().__init__(config, ctx, custom_headers)
+        super().__init__(config, ctx, custom_headers, verbose)
         self.base_url = self.config.base_url
         self.model = ImageConfig.DEFAULT_MODEL
 
-    def _extract_urls(self, response: ImageGenerationResponse) -> List[str]:
+    def extract_urls(self, response: ImageGenerationResponse) -> List[str]:
         urls = []
         for item in response.data:
             if item.error:
@@ -107,15 +108,3 @@ class ImageGenerationClient(BaseClient):
             sequential_image_generation,
             sequential_image_generation_max_images,
         )
-
-    async def batch_generate(
-        self, requests: List[Dict[str, Any]], max_concurrent: int = 5
-    ) -> List[ImageGenerationResponse]:
-        semaphore = asyncio.Semaphore(max_concurrent)
-
-        async def _generate_with_semaphore(request_params: Dict[str, Any]):
-            async with semaphore:
-                return await self.generate_async(**request_params)
-
-        tasks = [_generate_with_semaphore(req) for req in requests]
-        return await asyncio.gather(*tasks, return_exceptions=False)

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/llm/client.py

@@ -16,11 +16,19 @@ from .models import LLMConfig
 
 
 class LLMClient:
-    def __init__(self, config: Optional[Config] = None, ctx: Optional[Context] = None):
+    def __init__(
+        self,
+        config: Optional[Config] = None,
+        ctx: Optional[Context] = None,
+        custom_headers: Optional[Dict[str, str]] = None,
+        verbose: bool = False,
+    ):
         if config is None:
             config = Config()
         self.config = config
         self.ctx = ctx
+        self.custom_headers = custom_headers or {}
+        self.verbose = verbose
         self.base_url = self.config.base_model_url
         self.api_key = self.config.api_key
 
@@ -39,12 +47,18 @@ class LLMClient:
         if llm_config.caching:
             extra_body["caching"] = {"type": llm_config.caching}
 
-        headers = self.config.get_headers(extra_headers)
+        headers = {}
 
         if self.ctx is not None:
             ctx_headers = default_headers(self.ctx)
             headers.update(ctx_headers)
 
+        if self.custom_headers:
+            headers.update(self.custom_headers)
+
+        config_headers = self.config.get_headers(extra_headers)
+        headers.update(config_headers)
+
         llm = ChatOpenAI(
             model=llm_config.model,
             api_key=self.api_key,

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/search/client.py

@@ -79,8 +79,9 @@ class SearchClient(BaseClient):
         config: Optional[Config] = None,
         ctx: Optional[Context] = None,
         custom_headers: Optional[Dict[str, str]] = None,
+        verbose: bool = False,
     ):
-        super().__init__(config, ctx, custom_headers)
+        super().__init__(config, ctx, custom_headers, verbose)
         self.base_url = self.config.base_url
 
     @observe(name="web_search")

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/video/client.py

@@ -20,9 +20,10 @@ class VideoGenerationClient(BaseClient):
         self, 
         config: Optional[Config] = None, 
         ctx: Optional[Context] = None,
-        custom_headers: Optional[Dict[str, str]] = None
+        custom_headers: Optional[Dict[str, str]] = None,
+        verbose: bool = False
     ):
-        super().__init__(config, ctx, custom_headers)
+        super().__init__(config, ctx, custom_headers, verbose)
         self.base_url = self.config.base_url
 
     @observe(name="video_generation_create_task")

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/voice/asr.py

@@ -1,6 +1,7 @@
-from typing import Optional, Tuple, Dict
-from cozeloop.decorator import observe
+from typing import Dict, Optional, Tuple
+
 from coze_coding_utils.runtime_ctx.context import Context
+from cozeloop.decorator import observe
 
 from ..core.client import BaseClient
 from ..core.config import Config
@@ -10,50 +11,50 @@ from .models import ASRRequest, ASRResponse
 
 class ASRClient(BaseClient):
     def __init__(
-        self, 
-        config: Optional[Config] = None, 
+        self,
+        config: Optional[Config] = None,
         ctx: Optional[Context] = None,
-        custom_headers: Optional[Dict[str, str]] = None
+        custom_headers: Optional[Dict[str, str]] = None,
+        verbose: bool = False,
     ):
-        super().__init__(config, ctx, custom_headers)
+        super().__init__(config, ctx, custom_headers, verbose)
         self.base_url = self.config.base_url
+
     @observe
     def recognize(
         self,
         uid: Optional[str] = None,
         url: Optional[str] = None,
-        base64_data: Optional[str] = None
+        base64_data: Optional[str] = None,
     ) -> Tuple[str, dict]:
         if not (url or base64_data):
-            raise ValidationError("必须提供 url 或 base64_data 其中之一", field="url/base64_data")
-        
-        request = ASRRequest(
-            uid=uid,
-            url=url,
-            base64_data=base64_data
-        )
-        
+            raise ValidationError(
+                "必须提供 url 或 base64_data 其中之一", field="url/base64_data"
+            )
+
+        request = ASRRequest(uid=uid, url=url, base64_data=base64_data)
+
         headers = self.config.get_headers()
         response = self._make_request(
             method="POST",
             url=f"{self.base_url}/api/v3/auc/bigmodel/recognize/flash",
             json=request.to_api_request(),
-            headers=headers
+            headers=headers,
         )
-        
-        status_code = response.headers.get('X-Api-Status-Code', '0')
-        message = response.headers.get('X-Api-Message', '')
-        
-        if status_code != '20000000':
+
+        status_code = response.headers.get("X-Api-Status-Code", "0")
+        message = response.headers.get("X-Api-Message", "")
+
+        if status_code != "20000000":
             raise APIError(
                 f"识别失败: {message}",
                 code=status_code,
-                status_code=response.status_code
+                status_code=response.status_code,
             )
-        
+
         data = self._handle_response(response)
-        
+
         result = data.get("result", {})
         text = result.get("text", "")
-        
+
         return text, data

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk/voice/tts.py

@@ -1,8 +1,9 @@
-import json
 import base64
-from typing import Optional, Tuple, Dict
-from cozeloop.decorator import observe
+import json
+from typing import Dict, Optional, Tuple
+
 from coze_coding_utils.runtime_ctx.context import Context
+from cozeloop.decorator import observe
 
 from ..core.client import BaseClient
 from ..core.config import Config
@@ -12,13 +13,15 @@ from .models import TTSConfig, TTSRequest
 
 class TTSClient(BaseClient):
     def __init__(
-        self, 
-        config: Optional[Config] = None, 
+        self,
+        config: Optional[Config] = None,
         ctx: Optional[Context] = None,
-        custom_headers: Optional[Dict[str, str]] = None
+        custom_headers: Optional[Dict[str, str]] = None,
+        verbose: bool = False,
     ):
-        super().__init__(config, ctx, custom_headers)
+        super().__init__(config, ctx, custom_headers, verbose)
         self.base_url = self.config.base_url
+
     @observe
     def synthesize(
         self,
@@ -33,7 +36,7 @@ class TTSClient(BaseClient):
     ) -> Tuple[str, int]:
         if not (text or ssml):
             raise ValidationError("必须提供 text 或 ssml 其中之一", field="text/ssml")
-        
+
         request = TTSRequest(
             uid=uid,
             text=text,
@@ -42,49 +45,49 @@ class TTSClient(BaseClient):
             audio_format=audio_format,
             sample_rate=sample_rate,
             speech_rate=speech_rate,
-            loudness_rate=loudness_rate
+            loudness_rate=loudness_rate,
         )
-        
+
         headers = self.config.get_headers({"Connection": "keep-alive"})
         response = self._make_request(
             method="POST",
             url=f"{self.base_url}/api/v3/tts/unidirectional",
             json=request.to_api_request(),
             headers=headers,
-            stream=True
+            stream=True,
         )
-        
+
         try:
             audio_uri = None
             audio_data = bytearray()
             total_audio_size = 0
-            
+
             for chunk in response.iter_lines(decode_unicode=False):
                 if not chunk:
                     continue
-                
+
                 chunk_str = chunk.decode("utf-8").replace("data:", "")
                 data = json.loads(chunk_str)
-                
+
                 if data.get("code", 0) == 0 and "data" in data and data["data"]:
                     chunk_audio = base64.b64decode(data["data"])
                     audio_size = len(chunk_audio)
                     total_audio_size += audio_size
                     audio_data.extend(chunk_audio)
-                
+
                 elif data.get("code", 0) == 20000000:
-                    if 'url' in data and data['url']:
-                        audio_uri = data['url']
+                    if "url" in data and data["url"]:
+                        audio_uri = data["url"]
                     break
-                
+
                 elif data.get("code", 0) > 0:
                     raise APIError(
                         f"合成音频失败: {data.get('message', '')}",
-                        code=str(data.get('code', 0))
+                        code=str(data.get("code", 0)),
                     )
-            
+
             return audio_uri or "", total_audio_size
-            
+
         except json.JSONDecodeError as e:
             raise APIError(f"响应解析失败: {str(e)}")
         except Exception as e:

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4/coze_coding_dev_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coze-coding-dev-sdk
-Version: 0.4.2
+Version: 0.4.4
 Summary: Coze Coding Dev SDK - 优雅的多功能 AI SDK，支持图片生成、视频生成、语音合成、语音识别、大语言模型和联网搜索。包含命令行工具 coze-coding-ai，支持 Context 上下文追踪
 Author-email: Coze Coding Integration Team <support@coze.com>
 Maintainer-email: Coze Coding Integration Team <support@coze.com>

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/coze_coding_dev_sdk.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ coze_coding_dev_sdk/cli/cli.py
 coze_coding_dev_sdk/cli/constants.py
 coze_coding_dev_sdk/cli/image.py
 coze_coding_dev_sdk/cli/search.py
+coze_coding_dev_sdk/cli/utils.py
 coze_coding_dev_sdk/cli/video.py
 coze_coding_dev_sdk/cli/voice.py
 coze_coding_dev_sdk/core/__init__.py

{coze_coding_dev_sdk-0.4.2 → coze_coding_dev_sdk-0.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "coze-coding-dev-sdk"
-version = "0.4.2"
+version = "0.4.4"
 description = "Coze Coding Dev SDK - 优雅的多功能 AI SDK，支持图片生成、视频生成、语音合成、语音识别、大语言模型和联网搜索。包含命令行工具 coze-coding-ai，支持 Context 上下文追踪"
 readme = "README.md"
 requires-python = ">=3.11"

coze_coding_dev_sdk-0.4.2/coze_coding_dev_sdk/core/client.py

@@ -1,97 +0,0 @@
-import time
-from typing import Optional, Dict
-import requests
-from coze_coding_utils.runtime_ctx.context import Context, default_headers
-
-from .config import Config
-from .exceptions import APIError, NetworkError
-
-
-class BaseClient:
-    def __init__(
-        self, 
-        config: Optional[Config] = None, 
-        ctx: Optional[Context] = None,
-        custom_headers: Optional[Dict[str, str]] = None
-    ):
-        if config is None:
-            config = Config()
-        self.config = config
-        self.ctx = ctx
-        self.custom_headers = custom_headers or {}
-    
-    def _request(
-        self,
-        method: str,
-        url: str,
-        headers: Optional[Dict[str, str]] = None,
-        **kwargs
-    ) -> dict:
-        request_headers = self.config.get_headers(headers)
-        
-        if self.ctx is not None:
-            ctx_headers = default_headers(self.ctx)
-            request_headers.update(ctx_headers)
-        
-        response = self._make_request(
-            method=method,
-            url=url,
-            headers=request_headers,
-            **kwargs
-        )
-        return self._handle_response(response)
-    
-    def _make_request(
-        self,
-        method: str,
-        url: str,
-        **kwargs
-    ) -> requests.Response:
-        last_error = None
-        
-        for attempt in range(self.config.retry_times):
-            try:
-                response = requests.request(
-                    method=method,
-                    url=url,
-                    timeout=self.config.timeout,
-                    **kwargs
-                )
-                return response
-                
-            except requests.exceptions.RequestException as e:
-                last_error = NetworkError(str(e), e)
-                if attempt < self.config.retry_times - 1:
-                    time.sleep(self.config.retry_delay * (attempt + 1))
-                    continue
-        
-        raise last_error
-    
-    def _handle_response(self, response: requests.Response) -> dict:
-        try:
-            data = response.json()
-        except Exception as e:
-            raise APIError(
-                f"响应解析失败: {str(e)}, 响应内容: {response.text[:200]}",
-                status_code=response.status_code
-            )
-        
-        try:
-            response.raise_for_status()
-        except requests.exceptions.HTTPError as e:
-            error_msg = f"HTTP 错误: {str(e)}"
-            if data:
-                error_msg += f", 响应数据: {data}"
-            raise APIError(
-                error_msg,
-                status_code=response.status_code,
-                response_data=data
-            )
-        
-        return data
-    
-    def __enter__(self):
-        return self
-    
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        pass