开发者文档

API 文档

MangaLens API 接口说明和使用示例

认证方式

所有 API 请求需要通过 Clerk 认证

API 使用 Cookie 进行身份验证。请确保在浏览器中使用已登录的会话，或在服务端使用 Clerk SDK 进行认证。

# 认证头示例（服务端使用）

Authorization: Bearer <your-session-token>

API 端点

POST/api/generate需认证

AI 图片生成接口

请求体

imageData: base64 编码的图片数据

prompt: 生成提示词

provider: gemini | openai

model: 模型名称（可选）

响应

success: boolean

imageData: base64 编码的结果图片

error: 错误信息（失败时）

GET/api/projects需认证

获取用户项目列表

查询参数

page: 页码（默认 1）

limit: 每页数量（默认 20）

响应

projects: 项目数组

pagination: 分页信息

POST/api/projects需认证

创建新项目

请求体

name: 项目名称

description: 项目描述（可选）

响应

project: 创建的项目对象

GET/api/user/api-keys需认证

获取用户 API Key 列表（掩码）

响应

keys: API Key 列表（带掩码）

POST/api/user/api-keys需认证

保存 API Key

请求体

provider: gemini | openai | custom

apiKey: API Key 值

响应

success: boolean

代码示例

图片生成请求

fetch('/api/generate', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        imageData: 'data:image/png;base64,...',
        prompt: '将图中的日文翻译为中文',
        provider: 'gemini',
        model: 'gemini-2.5-flash-preview-05-20'
    })
})

获取项目列表

fetch('/api/projects?page=1&limit=10', {
    method: 'GET',
})

错误响应

API 错误返回格式

{

"error": "错误描述信息"

}

401 未认证或认证失败

400 请求参数错误

500 服务器内部错误