local-coze 0.0.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- local_coze/__init__.py +110 -0
- local_coze/cli/__init__.py +3 -0
- local_coze/cli/chat.py +126 -0
- local_coze/cli/cli.py +34 -0
- local_coze/cli/constants.py +7 -0
- local_coze/cli/db.py +81 -0
- local_coze/cli/embedding.py +193 -0
- local_coze/cli/image.py +162 -0
- local_coze/cli/knowledge.py +195 -0
- local_coze/cli/search.py +198 -0
- local_coze/cli/utils.py +41 -0
- local_coze/cli/video.py +191 -0
- local_coze/cli/video_edit.py +888 -0
- local_coze/cli/voice.py +351 -0
- local_coze/core/__init__.py +25 -0
- local_coze/core/client.py +253 -0
- local_coze/core/config.py +58 -0
- local_coze/core/exceptions.py +67 -0
- local_coze/database/__init__.py +29 -0
- local_coze/database/client.py +170 -0
- local_coze/database/migration.py +342 -0
- local_coze/embedding/__init__.py +31 -0
- local_coze/embedding/client.py +350 -0
- local_coze/embedding/models.py +130 -0
- local_coze/image/__init__.py +19 -0
- local_coze/image/client.py +110 -0
- local_coze/image/models.py +163 -0
- local_coze/knowledge/__init__.py +19 -0
- local_coze/knowledge/client.py +148 -0
- local_coze/knowledge/models.py +45 -0
- local_coze/llm/__init__.py +25 -0
- local_coze/llm/client.py +317 -0
- local_coze/llm/models.py +48 -0
- local_coze/memory/__init__.py +14 -0
- local_coze/memory/client.py +176 -0
- local_coze/s3/__init__.py +12 -0
- local_coze/s3/client.py +580 -0
- local_coze/s3/models.py +18 -0
- local_coze/search/__init__.py +19 -0
- local_coze/search/client.py +183 -0
- local_coze/search/models.py +57 -0
- local_coze/video/__init__.py +17 -0
- local_coze/video/client.py +347 -0
- local_coze/video/models.py +39 -0
- local_coze/video_edit/__init__.py +23 -0
- local_coze/video_edit/examples.py +340 -0
- local_coze/video_edit/frame_extractor.py +176 -0
- local_coze/video_edit/models.py +362 -0
- local_coze/video_edit/video_edit.py +631 -0
- local_coze/voice/__init__.py +17 -0
- local_coze/voice/asr.py +82 -0
- local_coze/voice/models.py +86 -0
- local_coze/voice/tts.py +94 -0
- local_coze-0.0.1.dist-info/METADATA +636 -0
- local_coze-0.0.1.dist-info/RECORD +58 -0
- local_coze-0.0.1.dist-info/WHEEL +4 -0
- local_coze-0.0.1.dist-info/entry_points.txt +3 -0
- local_coze-0.0.1.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1,636 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: local-coze
|
|
3
|
+
Version: 0.0.1
|
|
4
|
+
Summary: Local Coze SDK - 优雅的多功能 AI SDK,支持图片生成、视频生成、语音合成、语音识别、大语言模型、联网搜索和文本/多模态 Embedding。包含命令行工具 local-coze,支持 Context 上下文追踪
|
|
5
|
+
License: MIT
|
|
6
|
+
License-File: LICENSE
|
|
7
|
+
Keywords: coze,coze-coding,integration,ai,sdk,image-generation,video-generation,text-to-speech,speech-recognition,llm,search,embedding,vector-embedding,semantic-search,rag,doubao,seedream
|
|
8
|
+
Author: Coze Coding Integration Team
|
|
9
|
+
Author-email: support@coze.com
|
|
10
|
+
Maintainer: Coze Coding Integration Team
|
|
11
|
+
Maintainer-email: support@coze.com
|
|
12
|
+
Requires-Python: >=3.11
|
|
13
|
+
Classifier: Development Status :: 4 - Beta
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
16
|
+
Classifier: Operating System :: OS Independent
|
|
17
|
+
Classifier: Programming Language :: Python :: 3
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
22
|
+
Classifier: Topic :: Multimedia :: Graphics
|
|
23
|
+
Classifier: Topic :: Multimedia :: Sound/Audio
|
|
24
|
+
Classifier: Topic :: Multimedia :: Video
|
|
25
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
26
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
27
|
+
Requires-Dist: alembic (>=1.13.0)
|
|
28
|
+
Requires-Dist: boto3 (>=1.26.0)
|
|
29
|
+
Requires-Dist: click (>=8.0.0)
|
|
30
|
+
Requires-Dist: coze-coding-utils (>=0.1.0)
|
|
31
|
+
Requires-Dist: cozeloop (>=0.1.0)
|
|
32
|
+
Requires-Dist: langchain-core (>=0.1.0)
|
|
33
|
+
Requires-Dist: langchain-openai (>=0.1.0)
|
|
34
|
+
Requires-Dist: langgraph (>=0.2.0)
|
|
35
|
+
Requires-Dist: langgraph-checkpoint-postgres (>=3.0.0)
|
|
36
|
+
Requires-Dist: psycopg-pool (>=3.0.0)
|
|
37
|
+
Requires-Dist: psycopg[binary] (>=3.0.0)
|
|
38
|
+
Requires-Dist: pydantic (>=2.0.0)
|
|
39
|
+
Requires-Dist: requests (>=2.31.0)
|
|
40
|
+
Requires-Dist: rich (>=13.0.0)
|
|
41
|
+
Requires-Dist: sqlacodegen (>=3.0.0)
|
|
42
|
+
Requires-Dist: sqlalchemy (>=2.0.0)
|
|
43
|
+
Project-URL: Changelog, https://github.com/coze/local-coze/blob/main/CHANGELOG.md
|
|
44
|
+
Project-URL: Documentation, https://github.com/coze/local-coze#readme
|
|
45
|
+
Project-URL: Homepage, https://github.com/coze/local-coze
|
|
46
|
+
Project-URL: Issues, https://github.com/coze/local-coze/issues
|
|
47
|
+
Project-URL: Repository, https://github.com/coze/local-coze
|
|
48
|
+
Description-Content-Type: text/markdown
|
|
49
|
+
|
|
50
|
+
# Coze Coding Dev SDK
|
|
51
|
+
|
|
52
|
+
> 优雅、模块化的多功能 AI SDK,支持图片生成、视频生成、语音合成、语音识别、大语言模型和联网搜索。同时提供强大的命令行工具 `coze-coding-ai`。
|
|
53
|
+
|
|
54
|
+
[](https://www.python.org/downloads/)
|
|
55
|
+
[](https://pypi.org/project/coze-coding-dev-sdk/)
|
|
56
|
+
[](LICENSE)
|
|
57
|
+
[](https://pypi.org/project/coze-coding-dev-sdk/)
|
|
58
|
+
|
|
59
|
+
## ✨ 特性
|
|
60
|
+
|
|
61
|
+
- 🎨 **图片生成** - 基于豆包 SeeDream 模型的高质量图片生成 (2K/4K)
|
|
62
|
+
- 🎬 **视频生成** - 文本/图片生成视频,支持多种模型和配置
|
|
63
|
+
- 🤖 **大语言模型** - 支持流式对话、思考链、缓存机制
|
|
64
|
+
- 🔍 **联网搜索** - Web 搜索、AI 总结、图片搜索
|
|
65
|
+
- 🎙️ **语音合成 (TTS)** - 多音色、高质量的文本转语音
|
|
66
|
+
- 🎧 **语音识别 (ASR)** - 快速准确的语音转文字
|
|
67
|
+
- 🏗️ **模块化设计** - 清晰的模块划分,易于扩展
|
|
68
|
+
- 🔒 **类型安全** - 完整的类型提示
|
|
69
|
+
- 🔄 **自动重试** - 内置重试机制
|
|
70
|
+
- 📊 **可观测性** - 集成 cozeloop 监控
|
|
71
|
+
- 🛠️ **命令行工具** - 提供 `coze-coding-ai` CLI 工具,快速使用 AI 功能
|
|
72
|
+
|
|
73
|
+
## 📦 安装
|
|
74
|
+
|
|
75
|
+
### 仅安装 SDK
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
pip install coze-coding-dev-sdk
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
### 安装 SDK + CLI 工具
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
pip install coze-coding-dev-sdk[cli]
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 开发安装
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
git clone https://github.com/coze/coze-coding-dev-sdk.git
|
|
91
|
+
cd coze-coding-dev-sdk/packages/python
|
|
92
|
+
pip install -e ".[dev]"
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## 🚀 快速开始
|
|
96
|
+
|
|
97
|
+
### 环境配置
|
|
98
|
+
|
|
99
|
+
#### 必需配置
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
export COZE_WORKLOAD_IDENTITY_API_KEY="your_api_key"
|
|
103
|
+
export COZE_INTEGRATION_BASE_URL="https://api.coze.com"
|
|
104
|
+
export COZE_INTEGRATION_MODEL_BASE_URL="https://model.coze.com"
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
#### 可选配置(Cozeloop 监控)
|
|
108
|
+
|
|
109
|
+
如果需要使用扣子罗盘(Cozeloop)进行模型监控和可观测性追踪,需要额外配置:
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
export COZELOOP_WORKSPACE_ID="your_workspace_id"
|
|
113
|
+
export COZELOOP_API_TOKEN="your_api_token"
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
**获取 workspace_id 的方法:**
|
|
117
|
+
|
|
118
|
+
1. 登录扣子罗盘平台
|
|
119
|
+
2. 在项目设置或工作区设置中找到 `workspace_id`
|
|
120
|
+
3. 复制该 ID 并设置到环境变量中
|
|
121
|
+
|
|
122
|
+
**注意:** 如果不配置 Cozeloop 相关环境变量,会看到警告信息,但不影响 SDK 的正常使用。
|
|
123
|
+
|
|
124
|
+
### 图片生成
|
|
125
|
+
|
|
126
|
+
```python
|
|
127
|
+
from coze_coding_dev_sdk import ImageGenerationClient, ImageConfig
|
|
128
|
+
|
|
129
|
+
client = ImageGenerationClient()
|
|
130
|
+
|
|
131
|
+
files, response = client.generate(
|
|
132
|
+
prompt="一只可爱的橘猫坐在窗台上",
|
|
133
|
+
config=ImageConfig(size="4K", watermark=False)
|
|
134
|
+
)
|
|
135
|
+
|
|
136
|
+
print(f"图片 URL: {response.image_urls}")
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### 视频生成
|
|
140
|
+
|
|
141
|
+
```python
|
|
142
|
+
from coze_coding_dev_sdk import VideoGenerationClient, VideoConfig
|
|
143
|
+
|
|
144
|
+
client = VideoGenerationClient()
|
|
145
|
+
|
|
146
|
+
task = client.text_to_video(
|
|
147
|
+
prompt="一只可爱的小猫在草地上玩耍",
|
|
148
|
+
config=VideoConfig(resolution="1080p", ratio="16:9", duration=5)
|
|
149
|
+
)
|
|
150
|
+
|
|
151
|
+
print(f"视频 URL: {task.video_url}")
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### 大语言模型
|
|
155
|
+
|
|
156
|
+
```python
|
|
157
|
+
from coze_coding_dev_sdk import LLMClient
|
|
158
|
+
from langchain_core.messages import HumanMessage
|
|
159
|
+
|
|
160
|
+
client = LLMClient()
|
|
161
|
+
|
|
162
|
+
messages = [HumanMessage(content="你好,介绍一下你自己")]
|
|
163
|
+
|
|
164
|
+
for chunk in client.stream(messages=messages):
|
|
165
|
+
if chunk.content:
|
|
166
|
+
print(chunk.content, end="", flush=True)
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
### 联网搜索
|
|
170
|
+
|
|
171
|
+
```python
|
|
172
|
+
from coze_coding_dev_sdk import SearchClient
|
|
173
|
+
|
|
174
|
+
client = SearchClient()
|
|
175
|
+
|
|
176
|
+
results = client.web_search("Python 最新特性")
|
|
177
|
+
for item in results:
|
|
178
|
+
print(f"{item.title}: {item.url}")
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### 语音合成 (TTS)
|
|
182
|
+
|
|
183
|
+
```python
|
|
184
|
+
from coze_coding_dev_sdk import TTSClient
|
|
185
|
+
|
|
186
|
+
client = TTSClient()
|
|
187
|
+
|
|
188
|
+
audio_file, size = client.synthesize(
|
|
189
|
+
uid="user123",
|
|
190
|
+
text="你好,欢迎使用 Coze SDK!",
|
|
191
|
+
speaker="zh_female_xiaohe_uranus_bigtts"
|
|
192
|
+
)
|
|
193
|
+
|
|
194
|
+
print(f"音频文件: {audio_file.url}")
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
### 语音识别 (ASR)
|
|
198
|
+
|
|
199
|
+
```python
|
|
200
|
+
from coze_coding_dev_sdk import ASRClient
|
|
201
|
+
|
|
202
|
+
client = ASRClient()
|
|
203
|
+
|
|
204
|
+
text, data = client.recognize(
|
|
205
|
+
uid="user123",
|
|
206
|
+
url="https://example.com/audio.mp3"
|
|
207
|
+
)
|
|
208
|
+
|
|
209
|
+
print(f"识别结果: {text}")
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### 上下文追踪 (Context)
|
|
213
|
+
|
|
214
|
+
SDK 支持通过 Context 对象进行请求追踪和上下文管理。Context 会自动注入到 HTTP 请求头中,用于链路追踪、日志关联等场景。
|
|
215
|
+
|
|
216
|
+
```python
|
|
217
|
+
from coze_coding_dev_sdk import ImageGenerationClient
|
|
218
|
+
from coze_coding_utils.runtime_ctx.context import Context
|
|
219
|
+
|
|
220
|
+
# 创建 Context 对象
|
|
221
|
+
ctx = Context(
|
|
222
|
+
request_id="req-123456",
|
|
223
|
+
trace_id="trace-789",
|
|
224
|
+
user_id="user-001"
|
|
225
|
+
)
|
|
226
|
+
|
|
227
|
+
# 在初始化 Client 时传入 ctx
|
|
228
|
+
client = ImageGenerationClient(ctx=ctx)
|
|
229
|
+
|
|
230
|
+
# 后续所有请求都会自动携带 Context 信息
|
|
231
|
+
response = client.generate(prompt="一只可爱的小猫")
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
**支持 Context 的所有 Client:**
|
|
235
|
+
|
|
236
|
+
- `ImageGenerationClient` - 图片生成
|
|
237
|
+
- `VideoGenerationClient` - 视频生成
|
|
238
|
+
- `LLMClient` - 大语言模型
|
|
239
|
+
- `SearchClient` - 联网搜索
|
|
240
|
+
- `TTSClient` - 语音合成
|
|
241
|
+
- `ASRClient` - 语音识别
|
|
242
|
+
|
|
243
|
+
**注意事项:**
|
|
244
|
+
|
|
245
|
+
- Context 参数是可选的,不传入时不影响正常使用
|
|
246
|
+
- Context 只在 Client 初始化时传入,不需要在每个方法中传递
|
|
247
|
+
- Context 信息会通过 `default_headers()` 自动转换为 HTTP 请求头
|
|
248
|
+
|
|
249
|
+
## 📁 项目结构
|
|
250
|
+
|
|
251
|
+
```
|
|
252
|
+
coze-coding-dev-sdk/
|
|
253
|
+
├── coze_coding_dev_sdk/ # SDK 主包
|
|
254
|
+
│ ├── core/ # 核心层(配置、异常、基础客户端)
|
|
255
|
+
│ ├── image/ # 图片生成模块
|
|
256
|
+
│ ├── video/ # 视频生成模块
|
|
257
|
+
│ ├── llm/ # 大语言模型模块
|
|
258
|
+
│ ├── search/ # 联网搜索模块
|
|
259
|
+
│ └── voice/ # 语音模块(TTS + ASR)
|
|
260
|
+
├── examples/ # 使用示例
|
|
261
|
+
│ ├── image_examples/ # 图片生成示例
|
|
262
|
+
│ ├── video_examples/ # 视频生成示例
|
|
263
|
+
│ ├── llm_examples/ # LLM 示例
|
|
264
|
+
│ ├── search_examples/ # 搜索示例
|
|
265
|
+
│ └── voice_examples/ # 语音功能示例
|
|
266
|
+
├── LICENSE # MIT 许可证
|
|
267
|
+
├── CHANGELOG.md # 版本变更记录
|
|
268
|
+
└── README.md # 项目文档
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
## 🎯 核心模块
|
|
272
|
+
|
|
273
|
+
### 1. 图片生成 (Image)
|
|
274
|
+
|
|
275
|
+
```python
|
|
276
|
+
from coze_coding_dev_sdk import ImageGenerationClient, ImageConfig
|
|
277
|
+
|
|
278
|
+
client = ImageGenerationClient()
|
|
279
|
+
|
|
280
|
+
files, response = client.generate(
|
|
281
|
+
prompt="壮丽的雪山日出",
|
|
282
|
+
config=ImageConfig(size="4K", watermark=False)
|
|
283
|
+
)
|
|
284
|
+
|
|
285
|
+
results = await client.batch_generate([
|
|
286
|
+
{"prompt": "春天的樱花", "size": "2K"},
|
|
287
|
+
{"prompt": "夏日的海滩", "size": "4K"},
|
|
288
|
+
])
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
**功能特性:**
|
|
292
|
+
|
|
293
|
+
- 支持 2K/4K 或自定义尺寸
|
|
294
|
+
- 同步/异步双模式
|
|
295
|
+
- 批量并发生成
|
|
296
|
+
- 参考图片风格迁移
|
|
297
|
+
- 组图生成
|
|
298
|
+
|
|
299
|
+
### 2. 视频生成 (Video)
|
|
300
|
+
|
|
301
|
+
```python
|
|
302
|
+
from coze_coding_dev_sdk import VideoGenerationClient, VideoConfig
|
|
303
|
+
|
|
304
|
+
client = VideoGenerationClient()
|
|
305
|
+
|
|
306
|
+
task = client.image_to_video(
|
|
307
|
+
prompt="小猫从坐着到站起来",
|
|
308
|
+
first_frame_url="https://example.com/cat_sitting.jpg",
|
|
309
|
+
last_frame_url="https://example.com/cat_standing.jpg",
|
|
310
|
+
config=VideoConfig(resolution="1080p", duration=5)
|
|
311
|
+
)
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
**功能特性:**
|
|
315
|
+
|
|
316
|
+
- 文本生成视频(text-to-video)
|
|
317
|
+
- 图片生成视频(image-to-video)
|
|
318
|
+
- 支持首帧、尾帧、参考图片
|
|
319
|
+
- 异步任务轮询
|
|
320
|
+
- 多种分辨率和比例
|
|
321
|
+
|
|
322
|
+
### 3. 大语言模型 (LLM)
|
|
323
|
+
|
|
324
|
+
```python
|
|
325
|
+
from coze_coding_dev_sdk import LLMClient
|
|
326
|
+
|
|
327
|
+
client = LLMClient()
|
|
328
|
+
|
|
329
|
+
response = client.chat(
|
|
330
|
+
messages=[{"role": "user", "content": "解释量子计算"}],
|
|
331
|
+
enable_thinking=True,
|
|
332
|
+
enable_cache=True
|
|
333
|
+
)
|
|
334
|
+
|
|
335
|
+
for chunk in client.chat_stream(messages=[...]):
|
|
336
|
+
print(chunk, end="")
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
**功能特性:**
|
|
340
|
+
|
|
341
|
+
- 流式和非流式对话
|
|
342
|
+
- 思考链(thinking)
|
|
343
|
+
- 缓存机制
|
|
344
|
+
- 多模态支持
|
|
345
|
+
- 集成 LangChain
|
|
346
|
+
|
|
347
|
+
### 4. 联网搜索 (Search)
|
|
348
|
+
|
|
349
|
+
```python
|
|
350
|
+
from coze_coding_dev_sdk import SearchClient
|
|
351
|
+
|
|
352
|
+
client = SearchClient()
|
|
353
|
+
|
|
354
|
+
web_results = client.web_search("AI 最新进展")
|
|
355
|
+
|
|
356
|
+
summary, results = client.web_search_with_summary("量子计算原理")
|
|
357
|
+
|
|
358
|
+
images = client.image_search("可爱的猫咪")
|
|
359
|
+
```
|
|
360
|
+
|
|
361
|
+
**功能特性:**
|
|
362
|
+
|
|
363
|
+
- Web 搜索
|
|
364
|
+
- Web 搜索 + AI 总结
|
|
365
|
+
- 图片搜索
|
|
366
|
+
- 结构化结果返回
|
|
367
|
+
|
|
368
|
+
### 5. 语音合成 (TTS)
|
|
369
|
+
|
|
370
|
+
```python
|
|
371
|
+
from coze_coding_dev_sdk import TTSClient, TTSConfig
|
|
372
|
+
|
|
373
|
+
client = TTSClient()
|
|
374
|
+
|
|
375
|
+
audio, size = client.synthesize(
|
|
376
|
+
uid="user123",
|
|
377
|
+
text="你好世界",
|
|
378
|
+
speaker="zh_female_xiaohe_uranus_bigtts",
|
|
379
|
+
audio_format="mp3",
|
|
380
|
+
speech_rate=0
|
|
381
|
+
)
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
**功能特性:**
|
|
385
|
+
|
|
386
|
+
- 30+ 音色选择
|
|
387
|
+
- 支持 SSML 格式
|
|
388
|
+
- 可调节语速和音量
|
|
389
|
+
- 多种音频格式(MP3/PCM/OGG)
|
|
390
|
+
- 流式返回
|
|
391
|
+
|
|
392
|
+
### 6. 语音识别 (ASR)
|
|
393
|
+
|
|
394
|
+
```python
|
|
395
|
+
from coze_coding_dev_sdk import ASRClient
|
|
396
|
+
|
|
397
|
+
client = ASRClient()
|
|
398
|
+
|
|
399
|
+
text, data = client.recognize(
|
|
400
|
+
uid="user123",
|
|
401
|
+
url="https://example.com/audio.mp3"
|
|
402
|
+
)
|
|
403
|
+
```
|
|
404
|
+
|
|
405
|
+
**功能特性:**
|
|
406
|
+
|
|
407
|
+
- 支持 URL 和 Base64 输入
|
|
408
|
+
- 多种音频格式
|
|
409
|
+
- 详细的时间戳信息
|
|
410
|
+
- 最长 2 小时音频
|
|
411
|
+
|
|
412
|
+
## 🔧 高级配置
|
|
413
|
+
|
|
414
|
+
### 统一配置
|
|
415
|
+
|
|
416
|
+
```python
|
|
417
|
+
from coze_coding_dev_sdk import Config, ImageGenerationClient, TTSClient
|
|
418
|
+
|
|
419
|
+
config = Config(
|
|
420
|
+
api_key="your_api_key",
|
|
421
|
+
base_url="https://api.coze.com",
|
|
422
|
+
retry_times=5,
|
|
423
|
+
retry_delay=2.0,
|
|
424
|
+
timeout=120
|
|
425
|
+
)
|
|
426
|
+
|
|
427
|
+
image_client = ImageGenerationClient(config=config)
|
|
428
|
+
tts_client = TTSClient(config=config)
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
### 异常处理
|
|
432
|
+
|
|
433
|
+
```python
|
|
434
|
+
from coze_coding_dev_sdk import (
|
|
435
|
+
CozeSDKError,
|
|
436
|
+
APIError,
|
|
437
|
+
NetworkError,
|
|
438
|
+
ValidationError,
|
|
439
|
+
ConfigurationError
|
|
440
|
+
)
|
|
441
|
+
|
|
442
|
+
try:
|
|
443
|
+
files, response = client.generate(prompt="测试")
|
|
444
|
+
except ValidationError as e:
|
|
445
|
+
print(f"参数错误: {e.field} = {e.value}")
|
|
446
|
+
except APIError as e:
|
|
447
|
+
print(f"API 错误: {e.message}, 状态码: {e.status_code}")
|
|
448
|
+
except NetworkError as e:
|
|
449
|
+
print(f"网络错误: {e}")
|
|
450
|
+
except ConfigurationError as e:
|
|
451
|
+
print(f"配置错误: {e.missing_key}")
|
|
452
|
+
```
|
|
453
|
+
|
|
454
|
+
## 💡 使用示例
|
|
455
|
+
|
|
456
|
+
查看 `examples/` 目录获取更多示例:
|
|
457
|
+
|
|
458
|
+
- `examples/image_examples/` - 图片生成示例
|
|
459
|
+
- `examples/video_examples/` - 视频生成示例
|
|
460
|
+
- `examples/llm_examples/` - 大语言模型示例
|
|
461
|
+
- `examples/search_examples/` - 联网搜索示例
|
|
462
|
+
- `examples/voice_examples/` - 语音功能示例
|
|
463
|
+
|
|
464
|
+
运行示例:
|
|
465
|
+
|
|
466
|
+
```bash
|
|
467
|
+
python examples/image_examples/simple_example.py
|
|
468
|
+
python examples/video_examples/text_to_video.py
|
|
469
|
+
python examples/llm_examples/simple_chat.py
|
|
470
|
+
python examples/search_examples/web_search.py
|
|
471
|
+
python examples/voice_examples/tts_example.py
|
|
472
|
+
```
|
|
473
|
+
|
|
474
|
+
## 🛠️ 命令行工具 (CLI)
|
|
475
|
+
|
|
476
|
+
安装 CLI 工具后,可以直接在命令行中使用 AI 功能:
|
|
477
|
+
|
|
478
|
+
```bash
|
|
479
|
+
# 安装 CLI
|
|
480
|
+
pip install coze-coding-dev-sdk[cli]
|
|
481
|
+
|
|
482
|
+
# 查看帮助
|
|
483
|
+
coze-coding-ai --help
|
|
484
|
+
```
|
|
485
|
+
|
|
486
|
+
### 图片生成
|
|
487
|
+
|
|
488
|
+
**支持的图片尺寸:**
|
|
489
|
+
|
|
490
|
+
- `2K` (默认, ~2560x1440)
|
|
491
|
+
- `4K` (~3840x2160)
|
|
492
|
+
- 自定义: `WIDTHxHEIGHT` (宽度 2560-4096, 高度 1440-4096)
|
|
493
|
+
|
|
494
|
+
```bash
|
|
495
|
+
# 文生图 (默认 2K)
|
|
496
|
+
coze-coding-ai image -p "A beautiful landscape" -o "./image.png"
|
|
497
|
+
|
|
498
|
+
# 4K 分辨率
|
|
499
|
+
coze-coding-ai image -p "Professional portrait" -o "./portrait.png" -s 4K
|
|
500
|
+
|
|
501
|
+
# 图生图
|
|
502
|
+
coze-coding-ai image \
|
|
503
|
+
-p "Transform into watercolor style" \
|
|
504
|
+
-i "https://example.com/photo.jpg" \
|
|
505
|
+
-o "./result.png"
|
|
506
|
+
```
|
|
507
|
+
|
|
508
|
+
### 视频生成
|
|
509
|
+
|
|
510
|
+
```bash
|
|
511
|
+
# 文生视频
|
|
512
|
+
coze-coding-ai video -p "A cat playing with a ball" --poll
|
|
513
|
+
|
|
514
|
+
# 图生视频
|
|
515
|
+
coze-coding-ai video \
|
|
516
|
+
-i "https://example.com/image.png" \
|
|
517
|
+
-p "Make the scene come alive" \
|
|
518
|
+
--poll
|
|
519
|
+
|
|
520
|
+
# 查询任务状态
|
|
521
|
+
coze-coding-ai video-status <task-id>
|
|
522
|
+
|
|
523
|
+
# Mock 模式(测试运行,不消耗配额)
|
|
524
|
+
coze-coding-ai video -p "Test video" --mock --poll
|
|
525
|
+
coze-coding-ai video-status <task-id> --mock
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
### Chat 对话
|
|
529
|
+
|
|
530
|
+
```bash
|
|
531
|
+
# 基础对话
|
|
532
|
+
coze-coding-ai chat -p "Hello, how are you?"
|
|
533
|
+
|
|
534
|
+
# 自定义系统提示词
|
|
535
|
+
coze-coding-ai chat \
|
|
536
|
+
-p "Review this code: function add(a,b) { return a+b; }" \
|
|
537
|
+
-s "You are an expert code reviewer" \
|
|
538
|
+
-o review.json
|
|
539
|
+
|
|
540
|
+
# 启用思考链 (Chain of Thought)
|
|
541
|
+
coze-coding-ai chat \
|
|
542
|
+
-p "Solve this math problem: If a train travels 120km in 2 hours, what's its speed?" \
|
|
543
|
+
-t \
|
|
544
|
+
-o solution.json
|
|
545
|
+
|
|
546
|
+
# 流式输出
|
|
547
|
+
coze-coding-ai chat \
|
|
548
|
+
-p "Write a short story about a robot" \
|
|
549
|
+
--stream
|
|
550
|
+
```
|
|
551
|
+
|
|
552
|
+
### 联网搜索
|
|
553
|
+
|
|
554
|
+
```bash
|
|
555
|
+
# 网页搜索(默认)
|
|
556
|
+
coze-coding-ai search "AI 最新进展"
|
|
557
|
+
|
|
558
|
+
# 网页搜索 + 指定结果数量
|
|
559
|
+
coze-coding-ai search "Python 教程" --count 20
|
|
560
|
+
|
|
561
|
+
# 网页搜索 + AI 智能摘要
|
|
562
|
+
coze-coding-ai search "量子计算原理" --type web_summary
|
|
563
|
+
|
|
564
|
+
# 图片搜索
|
|
565
|
+
coze-coding-ai search "可爱的猫咪" --type image
|
|
566
|
+
coze-coding-ai search "可爱的猫咪" -t image -c 20
|
|
567
|
+
|
|
568
|
+
# 高级过滤 - 指定站点
|
|
569
|
+
coze-coding-ai search "Python 教程" --sites "python.org,github.com"
|
|
570
|
+
|
|
571
|
+
# 高级过滤 - 屏蔽站点
|
|
572
|
+
coze-coding-ai search "新闻" --block-hosts "example.com"
|
|
573
|
+
|
|
574
|
+
# 高级过滤 - 时间范围(1d=1天, 1w=1周, 1m=1月)
|
|
575
|
+
coze-coding-ai search "最新科技" --time-range "1d"
|
|
576
|
+
|
|
577
|
+
# 高级过滤 - 仅返回有正文的结果
|
|
578
|
+
coze-coding-ai search "技术文章" --need-content
|
|
579
|
+
|
|
580
|
+
# 保存结果到 JSON 文件
|
|
581
|
+
coze-coding-ai search "AI 研究" -o results.json
|
|
582
|
+
|
|
583
|
+
# 不同输出格式
|
|
584
|
+
coze-coding-ai search "Python" --format table # 表格格式(默认)
|
|
585
|
+
coze-coding-ai search "Python" --format simple # 简单文本格式
|
|
586
|
+
coze-coding-ai search "Python" --format json # JSON 格式
|
|
587
|
+
```
|
|
588
|
+
|
|
589
|
+
**搜索类型说明:**
|
|
590
|
+
|
|
591
|
+
- `web` - 普通网页搜索(默认)
|
|
592
|
+
- `image` - 图片搜索
|
|
593
|
+
- `web_summary` - 网页搜索 + AI 智能摘要
|
|
594
|
+
|
|
595
|
+
**高级过滤选项:**
|
|
596
|
+
|
|
597
|
+
- `--count, -c` - 返回结果数量(默认 10)
|
|
598
|
+
- `--summary, -s` - 启用 AI 摘要(仅 web 类型)
|
|
599
|
+
- `--need-content` - 仅返回有正文的结果
|
|
600
|
+
- `--need-url` - 仅返回有原文链接的结果
|
|
601
|
+
- `--sites` - 指定搜索的站点范围(逗号分隔)
|
|
602
|
+
- `--block-hosts` - 屏蔽的站点(逗号分隔)
|
|
603
|
+
- `--time-range` - 发文时间范围(1d, 1w, 1m)
|
|
604
|
+
- `--output, -o` - 保存结果到 JSON 文件
|
|
605
|
+
- `--format, -f` - 输出格式(table, json, simple)
|
|
606
|
+
|
|
607
|
+
更多 CLI 使用说明请查看 [CLI 文档](https://github.com/coze/coze-coding-dev-sdk/blob/main/packages/shell/README.md)
|
|
608
|
+
|
|
609
|
+
## 📊 版本历史
|
|
610
|
+
|
|
611
|
+
查看 [CHANGELOG.md](CHANGELOG.md) 了解详细的版本变更记录。
|
|
612
|
+
|
|
613
|
+
## 🤝 贡献
|
|
614
|
+
|
|
615
|
+
欢迎提交 Issue 和 Pull Request!
|
|
616
|
+
|
|
617
|
+
查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解如何参与贡献。
|
|
618
|
+
|
|
619
|
+
## 📄 许可证
|
|
620
|
+
|
|
621
|
+
本项目采用 [MIT License](LICENSE) 开源协议。
|
|
622
|
+
|
|
623
|
+
## 🙏 致谢
|
|
624
|
+
|
|
625
|
+
基于 Coze AI Integrations 和豆包大模型构建。
|
|
626
|
+
|
|
627
|
+
## 📞 联系方式
|
|
628
|
+
|
|
629
|
+
- 项目主页: https://github.com/coze/coze-sdk
|
|
630
|
+
- 问题反馈: https://github.com/coze/coze-sdk/issues
|
|
631
|
+
- 邮箱: support@coze.com
|
|
632
|
+
|
|
633
|
+
## ⭐ Star History
|
|
634
|
+
|
|
635
|
+
如果这个项目对你有帮助,请给我们一个 Star ⭐️
|
|
636
|
+
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
local_coze/__init__.py,sha256=OHRKPscxjSgythzmQpaXLcU5CaqSmCD9CeYt-IgQFgU,2399
|
|
2
|
+
local_coze/cli/__init__.py,sha256=mR6I-ofyv_QKCCsrc3Z4SeyF4pRAnFM4K3eV8KIRF98,100
|
|
3
|
+
local_coze/cli/chat.py,sha256=QLBauq4-p9OjDoa2BgkUuUcR2k25cwAxGd6Y_rNd9UQ,4180
|
|
4
|
+
local_coze/cli/cli.py,sha256=NUZSEjqU5_cEg7eaBOFsQvplft6NhDk0CVkCoa6yrmw,743
|
|
5
|
+
local_coze/cli/constants.py,sha256=VnVzOHbBZ44j86UCWvKAR0wrlCGqyuU2MjltZsLxCZw,119
|
|
6
|
+
local_coze/cli/db.py,sha256=ySLz5tj0G1XlZv0UJyCwQkpXkXywzoKl45a1fA7IJGI,2256
|
|
7
|
+
local_coze/cli/embedding.py,sha256=r3NLN6mBZOZUlZExj1NunhopdmMPouStGrvyokxOxeo,6263
|
|
8
|
+
local_coze/cli/image.py,sha256=8a4M2LcO9HSAjY--4ihpq764gGCoHjytuvVXilQ_Cck,5138
|
|
9
|
+
local_coze/cli/knowledge.py,sha256=WjmBYG81QYEkflZPekN5EQAB99W8Ykt_4uyrA4umOGs,5863
|
|
10
|
+
local_coze/cli/search.py,sha256=LKsplPMDQHILGUAr5wu2ARPVWYpQpu_FjjdFAVIAdf4,8130
|
|
11
|
+
local_coze/cli/utils.py,sha256=GkVHRrfVvMIfPQnQ9bngIZ3bgm6TwrdCr3CZ-5Enyv8,1116
|
|
12
|
+
local_coze/cli/video.py,sha256=kHIBNcdVdwnx5EPXAdkFfzJ0zXq4mqXUfBYfNVMVkv4,6695
|
|
13
|
+
local_coze/cli/video_edit.py,sha256=fJM4jvwIhWMekHxKHKXhEWjYzkHjalR3oeOULVn8lIM,31699
|
|
14
|
+
local_coze/cli/voice.py,sha256=ecz1YvXqsaP-Z4M-gjGR6Am-dF_M4BIgzc3qLOqTAqY,12111
|
|
15
|
+
local_coze/core/__init__.py,sha256=IEtDGYuzifulHEcx_McFJXulIcjNkQKEKLYfpAHoQPc,434
|
|
16
|
+
local_coze/core/client.py,sha256=TTF5ShvEMqTcwPe302ezwCA90uNnK3E0mxO5tfd9ZcY,8353
|
|
17
|
+
local_coze/core/config.py,sha256=DvI0Uq0XHEKDjY6PrbLEMcx7XLGFkmfiDBgQM2mdb2A,1922
|
|
18
|
+
local_coze/core/exceptions.py,sha256=R4l8famgq8OsdUd5Lp5Lxn9AGcLI8ArmYa43rrWB0Vk,1991
|
|
19
|
+
local_coze/database/__init__.py,sha256=KfL38xBh0eVNmir28g9j2iYZnCLX1VhGvz34zN8C8tQ,470
|
|
20
|
+
local_coze/database/client.py,sha256=D6adRymZTXDdPkJ1vp8TnjMgj9yCmlBreBmNUgVwEZ4,3915
|
|
21
|
+
local_coze/database/migration.py,sha256=BBog-rRX0RwKf0wl2r9VhsnSwq0_0343dvV6KZS7zqY,9892
|
|
22
|
+
local_coze/embedding/__init__.py,sha256=U_VMURrBZ4cS9y2JD13c7wwMgy67JqT5r5UIW3Hloiw,698
|
|
23
|
+
local_coze/embedding/client.py,sha256=RecyglpS1sdOIcY3IGQJcqSzD2REsh3QeJR8cBBoFvI,11181
|
|
24
|
+
local_coze/embedding/models.py,sha256=-eQLwQP4A8N_l0GE4a3hgcsKewAx8-JaLfPqSg5P7f0,5690
|
|
25
|
+
local_coze/image/__init__.py,sha256=gIrmP2AZcTGRl8Sn0ipix6vkeylPHrCQxdrV4B2xv5U,359
|
|
26
|
+
local_coze/image/client.py,sha256=wPBoRZb7VrBEe1LA2wmX0xXjw_tfYJG_vhUdzUOW71o,3988
|
|
27
|
+
local_coze/image/models.py,sha256=nGuZI3vdPWyo713XMfAwYHgzuCgmyjzz67rnD36noS0,5528
|
|
28
|
+
local_coze/knowledge/__init__.py,sha256=GtCmVKLsrLdMLiCBgjaHXdDkITIh0msd_Vx_DX032Y4,386
|
|
29
|
+
local_coze/knowledge/client.py,sha256=SdSST3Rx7IwKTHQMl9oTDBd1sZa4jm4jb_Gz3sszoUo,4811
|
|
30
|
+
local_coze/knowledge/models.py,sha256=BJsyP3z5sqLqBcHqfPyBJL-UjznEinOgr5Tiebc7egg,1826
|
|
31
|
+
local_coze/llm/__init__.py,sha256=07QVOn6_FbrRKizlGnNFUxhK5aezgn6qdtmppznFaRg,448
|
|
32
|
+
local_coze/llm/client.py,sha256=6EoUKnVBv6nIVEgd3AKLPC3m4cV1kV9PcZfqeJJmj-k,12100
|
|
33
|
+
local_coze/llm/models.py,sha256=ij4Uvr0AQ1GbbuHfI-uTxlus8d2QrcWE0cyXiJVEPAQ,1792
|
|
34
|
+
local_coze/memory/__init__.py,sha256=WdwARckCWRUPgIwp2FhsxnWVtdYcHcnjimcg0TEl4rg,181
|
|
35
|
+
local_coze/memory/client.py,sha256=OwbjZXEn0eqm9CpRE-Vdw7mMnf1Vsl_zV__gAtjs92U,5928
|
|
36
|
+
local_coze/s3/__init__.py,sha256=Rca0FvlulnQ5mmZc5o2-3rxyhZezzXL-CUrhpXtO4Ak,215
|
|
37
|
+
local_coze/s3/client.py,sha256=crlMVtKJ4dHE0pT6o9Q1A4YsJrRucvsHQb0RFFba7F0,21035
|
|
38
|
+
local_coze/s3/models.py,sha256=Ur4kxNXgzcX_9PteVM2ENHtdJd7bonbRvLOkCGYFebY,281
|
|
39
|
+
local_coze/search/__init__.py,sha256=N6Fwq-wHVE-S1oS-i6oUn36FGtPZmwYP9QTQSyytnFs,302
|
|
40
|
+
local_coze/search/client.py,sha256=LYfXHyjvkOYq1c2sgDYlfYLDUQdW511pbseYSZ4G81g,5756
|
|
41
|
+
local_coze/search/models.py,sha256=HYDhrTERN655F64Lt5_4xjDNt0wE6Y5GqJ36eySllug,2841
|
|
42
|
+
local_coze/video/__init__.py,sha256=Xcy44Pn3yjl3-N-RJeA2H1O1NKVnw8H024a7LeXs2HM,328
|
|
43
|
+
local_coze/video/client.py,sha256=j-P10dYWeyY0BZwbcsBkPF27DhtHKT1m2CMJgcNwrFc,13587
|
|
44
|
+
local_coze/video/models.py,sha256=-coe0mi4dCYgpkWR9UpwP9v8iKltJ830FHwKB7_Sock,1086
|
|
45
|
+
local_coze/video_edit/__init__.py,sha256=Y5CzLyWTukV5yv2muGuDnwpH_GTt_qrj0wY6dGr9BUQ,466
|
|
46
|
+
local_coze/video_edit/examples.py,sha256=5U05R9uCFn9Aq9dSDP-MV2CbqHZ4hwQJ7pXECj4zMCY,9236
|
|
47
|
+
local_coze/video_edit/frame_extractor.py,sha256=GT5_SLW_rDgpI_L9Zc6vHh2mqVm1VUr6G8DRctjKO4I,5348
|
|
48
|
+
local_coze/video_edit/models.py,sha256=1fol0qcztvtfeGx-n1scdkWQ271pYGwdrbyYvs5AXuI,15183
|
|
49
|
+
local_coze/video_edit/video_edit.py,sha256=lbzeNWNATJ22e6IQihiAnoYXI_2DIG96eLeU_Rrvp3A,21772
|
|
50
|
+
local_coze/voice/__init__.py,sha256=ecRvs8xtvYIc93Dcaqk9BCReUOOEt_HvhEMx_LcnagQ,262
|
|
51
|
+
local_coze/voice/asr.py,sha256=1qpz62SNR6xSFkfEn9_03WLZAm4BixzEHHfPIpAs9qc,2513
|
|
52
|
+
local_coze/voice/models.py,sha256=2jRh8enlupkyAHdfbRw0zdOPT3p0XD95OWSAg2_OysE,2787
|
|
53
|
+
local_coze/voice/tts.py,sha256=9GIzGXuESbG0VuhON0LJ1aoKniwW1zInrQkPuW_i2EU,3146
|
|
54
|
+
local_coze-0.0.1.dist-info/METADATA,sha256=cSsb5op0X3qsP-qLX9U8YqdcZeG_Us7oepQ3OujBbqI,17084
|
|
55
|
+
local_coze-0.0.1.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
|
|
56
|
+
local_coze-0.0.1.dist-info/entry_points.txt,sha256=37kOTs7vjbu1CukoP1bEW71UwBBNOUI_CRQv6EqJaxs,54
|
|
57
|
+
local_coze-0.0.1.dist-info/licenses/LICENSE,sha256=RTlorGn8pATA9jBDus6j3KcNGKN0iVL0RYQw3NECCBo,1070
|
|
58
|
+
local_coze-0.0.1.dist-info/RECORD,,
|