Base URL
本参考文档中的所有端点均使用此接口地址。
https://api.juhenextvip.com开发者内容
通过兼容 OpenAI、Anthropic 或 Gemini 的格式使用 JuheNext API。本参考文档覆盖全部接口分组的鉴权、参数、请求示例与响应结构。
快速开始
本参考文档中的所有端点均使用此接口地址。
https://api.juhenextvip.com将 JuheNext API Key 作为 Bearer Token 发送。部分兼容 Gemini 的客户端也可使用 x-goog-api-key。
Authorization: Bearer <YOUR_API_KEY>请将生产 Key 保存在服务端环境变量中,不要在浏览器代码或公开仓库中暴露。
兼容 OpenAI、Responses、Anthropic Messages 与 Gemini 的接口。
/v1/chat/completions根据对话消息生成模型响应。兼容模型支持流式输出与工具调用。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 模型页面中的准确模型 ID。 |
messages必填 | array | body | 按时间顺序排列的对话消息。 |
max_completion_tokens可选 | integer | body | 允许生成的最大 Token 数。 |
reasoning_effort可选 | string | body | 支持推理的模型所使用的推理强度。
|
temperature可选 | number | body | 采样温度,具体支持情况取决于模型。 |
stream可选 | boolean | body | 设为 true 时通过 Server-Sent Events 返回结果。 |
tools可选 | array | body | 提供给模型调用的工具或函数。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1/chat/completions' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-luna",
"messages": [
{
"role": "developer",
"content": "You are a helpful assistant."
},
{
"role": "user",
"content": "Hello!"
}
]
}'{
"id": "chatcmpl_...",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! How can I help?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 24,
"completion_tokens": 9,
"total_tokens": 33
}
}/v1/responses使用 OpenAI Responses 格式创建响应,可传入指令、推理配置和工具。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 准确的模型 ID。 |
input必填 | string | array | body | 文本或结构化输入项。 |
instructions可选 | string | body | 本次响应的系统级指令。 |
max_output_tokens可选 | integer | body | 最大输出 Token 数。 |
reasoning可选 | object | body | 支持推理的模型所使用的推理配置。 |
stream可选 | boolean | body | 设为 true 时流式返回响应事件。 |
tools可选 | array | body | 响应过程中可用的工具。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1/responses' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-luna",
"instructions": "Answer clearly and briefly.",
"input": "Explain what an API gateway does."
}'{
"id": "resp_...",
"object": "response",
"status": "completed",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "An API gateway is a single entry point..."
}
]
}
]
}/v1/messages使用兼容 Anthropic 的 Messages 格式创建消息。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 准确的兼容模型 ID。 |
messages必填 | array | body | 本次对话的输入消息。 |
max_tokens必填 | integer | body | 允许生成的最大 Token 数。 |
stream可选 | boolean | body | 设为 true 时流式返回消息事件。 |
thinking可选 | object | body | 支持扩展思考的模型所使用的配置。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1/messages' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "Summarize the benefits of caching."
}
]
}'{
"id": "msg_...",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Caching reduces latency and upstream load..."
}
],
"stop_reason": "end_turn"
}/v1beta/models/{model}:{GenerateContentType}使用兼容 Gemini 的接口生成普通或流式内容。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | path | 兼容 Gemini 的模型 ID。 |
GenerateContentType必填 | string | path | 拼接在模型名称后的生成方式。
|
contents必填 | array | body | 对话内容及其 parts。 |
generationConfig可选 | object | body | 可选的采样与输出配置。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1beta/models/gemini-3.5-flash:generateContent' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Explain edge computing in one paragraph." }
]
}
]
}'{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{ "text": "Edge computing processes data closer..." }
]
},
"finishReason": "STOP"
}
]
}使用兼容 OpenAI 与 Gemini 的格式生成和编辑图片。
/v1/images/generations根据文本提示词生成一张或多张图片。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 图片生成模型 ID。 |
prompt必填 | string | body | 需要生成的图片描述。 |
size可选 | string | body | 模型支持的预设尺寸或自定义 WxH 尺寸。 |
n可选 | integer | body | 模型支持时要生成的图片数量。 |
response_format可选 | string | body | 模型支持时所使用的图片返回格式。
|
curl --request POST \
--url 'https://api.juhenextvip.com/v1/images/generations' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-c",
"prompt": "A flying white rabbit in a futuristic sci-fi style",
"size": "1024x1536"
}'{
"created": 1785859200,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}/v1/images/edits根据文本提示词编辑上传的图片。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 图片编辑模型 ID。 |
prompt必填 | string | body | 描述目标编辑效果的指令。 |
image必填 | file | body | 源图片文件。 |
size可选 | string | body | 模型支持时所使用的输出尺寸。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1/images/edits' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--form 'model=gpt-image-2-c' \
--form 'prompt=Transform the image into a Studio Ghibli-inspired style' \
--form 'image=@/path/to/image.png' \
--form 'size=1024x1536'{
"created": 1785859200,
"data": [
{
"url": "https://example.com/edited-image.png"
}
]
}/v1beta/models/{model}:{GenerateContentType}使用兼容 Gemini 的多模态格式生成图片内容。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | path | 兼容的图片模型 ID。 |
contents必填 | array | body | 提示词以及可选的多模态输入 parts。 |
generationConfig可选 | object | body | 输出与生成选项。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1beta/models/gemini-3.1-flash-image:generateContent' \
--header 'x-goog-api-key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{ "text": "Create a minimal product photo of a glass teapot." }
]
}
]
}'{
"candidates": [
{
"content": {
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "<BASE64_IMAGE_DATA>"
}
}
]
}
}
]
}/v1/images/generations使用长宽比、分辨率和返回格式等参数生成 Grok 图片。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | Grok 图片模型 ID。 |
prompt必填 | string | body | 图片提示词。 |
aspect_ratio可选 | string | body | 目标长宽比。 |
n可选 | integer | body | 生成图片数量。 |
resolution可选 | string | body | 输出分辨率。
|
response_format可选 | string | body | 图片返回格式。
|
curl --request POST \
--url 'https://api.juhenextvip.com/v1/images/generations' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-image",
"prompt": "A quiet futuristic train station at blue hour",
"aspect_ratio": "16:9",
"resolution": "2k",
"response_format": "url"
}'{
"created": 1785859200,
"data": [
{ "url": "https://example.com/grok-image.png" }
]
}/v1/images/edits使用兼容 Grok 的图片模型编辑一张或多张源图片。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | Grok 图片编辑模型 ID。 |
prompt必填 | string | body | 编辑指令。 |
image / images必填 | file | array | body | 一张或多张源图片。 |
response_format可选 | string | body | 图片返回格式。
|
curl --request POST \
--url 'https://api.juhenextvip.com/v1/images/edits' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--form 'model=grok-imagine-image' \
--form 'prompt=Replace the background with a clean studio setting' \
--form 'image=@/path/to/source.png'{
"created": 1785859200,
"data": [
{ "url": "https://example.com/grok-edited-image.png" }
]
}创建异步视频任务,并查询其状态与结果。
/v1/videos创建一个异步 Grok 视频生成任务。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 视频生成模型 ID。 |
prompt必填 | string | body | 目标视频描述。 |
duration可选 | integer | body | 目标时长,单位为秒。 |
aspect_ratio可选 | string | body | 目标长宽比。 |
resolution可选 | string | body | 输出分辨率。
|
curl --request POST \
--url 'https://api.juhenextvip.com/v1/videos' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video",
"prompt": "A serene lake at sunrise with mist rolling over the water",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p"
}'{
"id": "task_...",
"object": "video",
"status": "queued"
}/v1/videos/{task_id}查询视频任务的当前状态和结果。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
task_id必填 | string | path | 创建请求返回的公开任务 ID。 |
curl --request GET \
--url 'https://api.juhenextvip.com/v1/videos/task_...' \
--header 'Authorization: Bearer <YOUR_API_KEY>'{
"id": "task_...",
"object": "video",
"status": "completed",
"url": "https://example.com/generated-video.mp4"
}审核可复用媒体素材,并创建 Seedance 2.0 视频任务。
/v1/video/generations提交一个图片、音频或视频 URL,用于可复用素材审核。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 与媒体类型匹配的审核模型。
|
prompt必填 | string | body | 素材的简短描述。 |
metadata.content必填 | array | body | 仅包含一个媒体项,类型为 image_url、audio_url 或 video_url。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1/video/generations' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-review-image",
"prompt": "Review this character reference image",
"metadata": {
"content": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/reference.png"
}
}
]
}
}'{
"id": "task_...",
"status": "queued",
"model": "seedance-review-image"
}/v1/video/generations/{task_id}查询素材审核结果及其可复用素材标识。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
task_id必填 | string | path | 公开的审核任务 ID。 |
curl --request GET \
--url 'https://api.juhenextvip.com/v1/video/generations/task_...' \
--header 'Authorization: Bearer <YOUR_API_KEY>'{
"id": "task_...",
"status": "completed",
"asset": "asset://asset-..."
}/v1/video/generations创建一个异步 Seedance 2.0 视频生成任务。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | Seedance 视频模型 ID。
|
prompt必填 | string | body | 视频提示词。 |
seconds必填 | string | body | 以 JSON 字符串传入的视频时长,支持 4 到 15。 |
images可选 | array | body | 可选的图片参考。 |
metadata.resolution可选 | string | body | 输出分辨率;fast 与 mini 支持 480p 和 720p。
|
metadata.ratio可选 | string | body | 输出长宽比。
|
metadata.content可选 | array | body | 任务使用的已审核素材引用。 |
metadata.callback_url可选 | string | body | 接收状态更新的 HTTPS 回调地址。 |
metadata.generate_audio可选 | boolean | body | 模型支持时是否生成音频。 |
metadata.service_tier可选 | string | body | 任务服务层级。
|
metadata.return_last_frame可选 | boolean | body | 模型支持时返回最后一帧。 |
metadata.seed可选 | integer | body | 生成随机种子;-1 表示随机。 |
metadata.watermark可选 | boolean | body | 是否添加水印。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1/video/generations' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-0",
"prompt": "Morning clouds drift slowly across snow-covered mountains as the camera moves forward smoothly",
"seconds": "5",
"metadata": {
"resolution": "720p",
"ratio": "16:9",
"generate_audio": true,
"seed": -1,
"watermark": false
}
}'{
"id": "task_...",
"status": "queued",
"model": "seedance-2-0"
}/v1/video/generations/{task_id}查询 Seedance 任务状态和生成的视频结果。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
task_id必填 | string | path | JuheNext 返回的公开 task_... ID。 |
curl --request GET \
--url 'https://api.juhenextvip.com/v1/video/generations/task_...' \
--header 'Authorization: Bearer <YOUR_API_KEY>'{
"id": "task_...",
"status": "completed",
"video_url": "https://example.com/seedance-video.mp4"
}创建向量、查询可用模型,并查看 API Key 额度。
/v1/embeddings为文本输入创建向量表示。
| 名称 | 类型 | 位置 | 说明 |
|---|---|---|---|
model必填 | string | body | 向量模型 ID。 |
input必填 | string | array | body | 要转换为向量的文本或文本数组。 |
encoding_format可选 | string | body | 向量编码格式。
|
dimensions可选 | integer | body | 模型支持时所使用的向量维度。 |
curl --request POST \
--url 'https://api.juhenextvip.com/v1/embeddings' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "text-embedding-3-small",
"input": "JuheNext makes model APIs easier to use.",
"encoding_format": "float"
}'{
"object": "list",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [0.0123, -0.0456, 0.0789]
}
],
"model": "text-embedding-3-small"
}/v1/models查询当前 API Key 可以使用的模型 ID。
curl --request GET \
--url 'https://api.juhenextvip.com/v1/models' \
--header 'Authorization: Bearer <YOUR_API_KEY>'{
"object": "list",
"data": [
{
"id": "gpt-5.6-luna",
"object": "model",
"owned_by": "provider"
}
]
}/api/usage/token查询当前 API Key 的额度与累计用量。
curl --request GET \
--url 'https://api.juhenextvip.com/api/usage/token' \
--header 'Authorization: Bearer <YOUR_API_KEY>'{
"data": {
"name": "JuheNext Key",
"expires_at": -1,
"total_granted": 5000000,
"total_used": 1250000,
"total_available": 3750000,
"unlimited_quota": false
}
}没有匹配的 API 文档。