开发者内容

API 文档

通过兼容 OpenAI、Anthropic 或 Gemini 的格式使用 JuheNext API。本参考文档覆盖全部接口分组的鉴权、参数、请求示例与响应结构。

快速开始

连接 JuheNext API

Base URL

本参考文档中的所有端点均使用此接口地址。

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 的接口。

POST/v1/chat/completions

创建对话补全

根据对话消息生成模型响应。兼容模型支持流式输出与工具调用。

参数

名称类型位置说明
model必填stringbody

模型页面中的准确模型 ID。

messages必填arraybody

按时间顺序排列的对话消息。

max_completion_tokens可选integerbody

允许生成的最大 Token 数。

reasoning_effort可选stringbody

支持推理的模型所使用的推理强度。

noneminimallowmediumhighxhighmax

temperature可选numberbody

采样温度,具体支持情况取决于模型。

stream可选booleanbody

设为 true 时通过 Server-Sent Events 返回结果。

tools可选arraybody

提供给模型调用的工具或函数。

cURL 请求

application/json
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!"
    }
  ]
}'

响应示例

JSON
{
  "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
  }
}

注意事项

  • 流式调用时将 stream 设为 true,并持续读取事件直至 [DONE]。
POST/v1/responses

创建响应

使用 OpenAI Responses 格式创建响应,可传入指令、推理配置和工具。

参数

名称类型位置说明
model必填stringbody

准确的模型 ID。

input必填string | arraybody

文本或结构化输入项。

instructions可选stringbody

本次响应的系统级指令。

max_output_tokens可选integerbody

最大输出 Token 数。

reasoning可选objectbody

支持推理的模型所使用的推理配置。

stream可选booleanbody

设为 true 时流式返回响应事件。

tools可选arraybody

响应过程中可用的工具。

cURL 请求

application/json
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."
}'

响应示例

JSON
{
  "id": "resp_...",
  "object": "response",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "An API gateway is a single entry point..."
        }
      ]
    }
  ]
}
POST/v1/messages

创建消息

使用兼容 Anthropic 的 Messages 格式创建消息。

参数

名称类型位置说明
model必填stringbody

准确的兼容模型 ID。

messages必填arraybody

本次对话的输入消息。

max_tokens必填integerbody

允许生成的最大 Token 数。

stream可选booleanbody

设为 true 时流式返回消息事件。

thinking可选objectbody

支持扩展思考的模型所使用的配置。

cURL 请求

application/json
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."
    }
  ]
}'

响应示例

JSON
{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Caching reduces latency and upstream load..."
    }
  ],
  "stop_reason": "end_turn"
}

注意事项

  • 请使用支持 Messages 格式的模型,接入前以实时模型页面为准。
POST/v1beta/models/{model}:{GenerateContentType}

生成 Gemini 内容

使用兼容 Gemini 的接口生成普通或流式内容。

参数

名称类型位置说明
model必填stringpath

兼容 Gemini 的模型 ID。

GenerateContentType必填stringpath

拼接在模型名称后的生成方式。

generateContentstreamGenerateContent

contents必填arraybody

对话内容及其 parts。

generationConfig可选objectbody

可选的采样与输出配置。

cURL 请求

application/json
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." }
      ]
    }
  ]
}'

响应示例

JSON
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          { "text": "Edge computing processes data closer..." }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}

图片

使用兼容 OpenAI 与 Gemini 的格式生成和编辑图片。

POST/v1/images/generations

生成图片

根据文本提示词生成一张或多张图片。

参数

名称类型位置说明
model必填stringbody

图片生成模型 ID。

prompt必填stringbody

需要生成的图片描述。

size可选stringbody

模型支持的预设尺寸或自定义 WxH 尺寸。

n可选integerbody

模型支持时要生成的图片数量。

response_format可选stringbody

模型支持时所使用的图片返回格式。

urlb64_json

cURL 请求

application/json
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"
}'

响应示例

JSON
{
  "created": 1785859200,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

注意事项

  • 使用兼容的自定义尺寸时,两边均须为 16 的倍数,最长边不超过 3840,长宽比不超过 3:1。
  • 不同模型的参数和限制可能不同,可用性以实时模型页面为准。
POST/v1/images/edits

编辑图片

根据文本提示词编辑上传的图片。

参数

名称类型位置说明
model必填stringbody

图片编辑模型 ID。

prompt必填stringbody

描述目标编辑效果的指令。

image必填filebody

源图片文件。

size可选stringbody

模型支持时所使用的输出尺寸。

cURL 请求

multipart/form-data
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'

响应示例

JSON
{
  "created": 1785859200,
  "data": [
    {
      "url": "https://example.com/edited-image.png"
    }
  ]
}
POST/v1beta/models/{model}:{GenerateContentType}

生成 Nano Banana 图片

使用兼容 Gemini 的多模态格式生成图片内容。

参数

名称类型位置说明
model必填stringpath

兼容的图片模型 ID。

contents必填arraybody

提示词以及可选的多模态输入 parts。

generationConfig可选objectbody

输出与生成选项。

cURL 请求

application/json
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." }
      ]
    }
  ]
}'

响应示例

JSON
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<BASE64_IMAGE_DATA>"
            }
          }
        ]
      }
    }
  ]
}

注意事项

  • 生成的图片位于 candidates[].content.parts[].inlineData。
POST/v1/images/generations

生成 Grok 图片

使用长宽比、分辨率和返回格式等参数生成 Grok 图片。

参数

名称类型位置说明
model必填stringbody

Grok 图片模型 ID。

prompt必填stringbody

图片提示词。

aspect_ratio可选stringbody

目标长宽比。

n可选integerbody

生成图片数量。

resolution可选stringbody

输出分辨率。

1k2k

response_format可选stringbody

图片返回格式。

urlb64_json

cURL 请求

application/json
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"
}'

响应示例

JSON
{
  "created": 1785859200,
  "data": [
    { "url": "https://example.com/grok-image.png" }
  ]
}
POST/v1/images/edits

编辑 Grok 图片

使用兼容 Grok 的图片模型编辑一张或多张源图片。

参数

名称类型位置说明
model必填stringbody

Grok 图片编辑模型 ID。

prompt必填stringbody

编辑指令。

image / images必填file | arraybody

一张或多张源图片。

response_format可选stringbody

图片返回格式。

urlb64_json

cURL 请求

application/json
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'

响应示例

JSON
{
  "created": 1785859200,
  "data": [
    { "url": "https://example.com/grok-edited-image.png" }
  ]
}

视频

创建异步视频任务,并查询其状态与结果。

POST/v1/videos

创建 Grok 视频

创建一个异步 Grok 视频生成任务。

参数

名称类型位置说明
model必填stringbody

视频生成模型 ID。

prompt必填stringbody

目标视频描述。

duration可选integerbody

目标时长,单位为秒。

aspect_ratio可选stringbody

目标长宽比。

resolution可选stringbody

输出分辨率。

480p720p1080p

cURL 请求

application/json
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"
}'

响应示例

JSON
{
  "id": "task_...",
  "object": "video",
  "status": "queued"
}
GET/v1/videos/{task_id}

查询 Grok 视频

查询视频任务的当前状态和结果。

参数

名称类型位置说明
task_id必填stringpath

创建请求返回的公开任务 ID。

cURL 请求

application/json
curl --request GET \
  --url 'https://api.juhenextvip.com/v1/videos/task_...' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

响应示例

JSON
{
  "id": "task_...",
  "object": "video",
  "status": "completed",
  "url": "https://example.com/generated-video.mp4"
}

注意事项

  • 请以合理的时间间隔轮询,并在任务进入最终状态后停止查询。

Seedance 2.0

审核可复用媒体素材,并创建 Seedance 2.0 视频任务。

POST/v1/video/generations

提交素材审核

提交一个图片、音频或视频 URL,用于可复用素材审核。

参数

名称类型位置说明
model必填stringbody

与媒体类型匹配的审核模型。

seedance-review-imageseedance-review-audioseedance-review-video

prompt必填stringbody

素材的简短描述。

metadata.content必填arraybody

仅包含一个媒体项,类型为 image_url、audio_url 或 video_url。

cURL 请求

application/json
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"
        }
      }
    ]
  }
}'

响应示例

JSON
{
  "id": "task_...",
  "status": "queued",
  "model": "seedance-review-image"
}

注意事项

  • 媒体地址必须是绝对 HTTPS URL,且 metadata.content 必须仅包含一个条目。
  • 审核通过后请保存持久化的 asset://asset-... 标识,不要保存临时签名 URL。
GET/v1/video/generations/{task_id}

查询素材审核

查询素材审核结果及其可复用素材标识。

参数

名称类型位置说明
task_id必填stringpath

公开的审核任务 ID。

cURL 请求

application/json
curl --request GET \
  --url 'https://api.juhenextvip.com/v1/video/generations/task_...' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

响应示例

JSON
{
  "id": "task_...",
  "status": "completed",
  "asset": "asset://asset-..."
}
POST/v1/video/generations

创建 Seedance 视频

创建一个异步 Seedance 2.0 视频生成任务。

参数

名称类型位置说明
model必填stringbody

Seedance 视频模型 ID。

seedance-2-0seedance-2-0-fastseedance-2-0-mini

prompt必填stringbody

视频提示词。

seconds必填stringbody

以 JSON 字符串传入的视频时长,支持 4 到 15。

images可选arraybody

可选的图片参考。

metadata.resolution可选stringbody

输出分辨率;fast 与 mini 支持 480p 和 720p。

480p720p1080p

metadata.ratio可选stringbody

输出长宽比。

1:116:99:164:33:43:22:3

metadata.content可选arraybody

任务使用的已审核素材引用。

metadata.callback_url可选stringbody

接收状态更新的 HTTPS 回调地址。

metadata.generate_audio可选booleanbody

模型支持时是否生成音频。

metadata.service_tier可选stringbody

任务服务层级。

defaultflex

metadata.return_last_frame可选booleanbody

模型支持时返回最后一帧。

metadata.seed可选integerbody

生成随机种子;-1 表示随机。

metadata.watermark可选booleanbody

是否添加水印。

cURL 请求

application/json
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
  }
}'

响应示例

JSON
{
  "id": "task_...",
  "status": "queued",
  "model": "seedance-2-0"
}

注意事项

  • 其他 metadata 字段可能取决于具体模型。建议先使用最少必填字段,再按需添加控制项。
GET/v1/video/generations/{task_id}

查询 Seedance 视频

查询 Seedance 任务状态和生成的视频结果。

参数

名称类型位置说明
task_id必填stringpath

JuheNext 返回的公开 task_... ID。

cURL 请求

application/json
curl --request GET \
  --url 'https://api.juhenextvip.com/v1/video/generations/task_...' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

响应示例

JSON
{
  "id": "task_...",
  "status": "completed",
  "video_url": "https://example.com/seedance-video.mp4"
}

注意事项

  • 请始终使用 JuheNext 返回的公开 task_... ID 查询,不要使用上游内部 ID。

模型与用量

创建向量、查询可用模型,并查看 API Key 额度。

POST/v1/embeddings

创建向量

为文本输入创建向量表示。

参数

名称类型位置说明
model必填stringbody

向量模型 ID。

input必填string | arraybody

要转换为向量的文本或文本数组。

encoding_format可选stringbody

向量编码格式。

floatbase64

dimensions可选integerbody

模型支持时所使用的向量维度。

cURL 请求

application/json
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"
}'

响应示例

JSON
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0123, -0.0456, 0.0789]
    }
  ],
  "model": "text-embedding-3-small"
}
GET/v1/models

查询模型列表

查询当前 API Key 可以使用的模型 ID。

cURL 请求

application/json
curl --request GET \
  --url 'https://api.juhenextvip.com/v1/models' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

响应示例

JSON
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.6-luna",
      "object": "model",
      "owned_by": "provider"
    }
  ]
}

注意事项

  • 不同 API Key 的可用模型可能不同且会动态调整,请以此接口或模型页面为实时依据。
GET/api/usage/token

查询 Key 用量

查询当前 API Key 的额度与累计用量。

cURL 请求

application/json
curl --request GET \
  --url 'https://api.juhenextvip.com/api/usage/token' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

响应示例

JSON
{
  "data": {
    "name": "JuheNext Key",
    "expires_at": -1,
    "total_granted": 5000000,
    "total_used": 1250000,
    "total_available": 3750000,
    "unlimited_quota": false
  }
}

注意事项

  • 公开用量查询页面还可以展示余额及最近最多 1000 条日志。
  • 字段是否存在以及数值单位请以实时接口响应为准。