easyai
e07a997aa9
兼容接口现在以入口协议作为最终响应协议，同协议保留官方 Wire 响应，跨协议统一转换成功、任务状态与错误结构。 同时修正异步提交状态边界，持久化兼容公开任务标识和官方提交响应，并新增迁移、流式响应及协议契约测试。 验证：go vet ./...；go test ./...；govulncheck ./...；pnpm lint；pnpm test；pnpm build；pnpm audit --audit-level high；pnpm openapi；全部 CI 脚本。
450 lines
16 KiB
Go
450 lines
16 KiB
Go
package httpapi
|
|
|
|
import (
|
|
"encoding/json"
|
|
"errors"
|
|
"net/http"
|
|
"strconv"
|
|
"strings"
|
|
"time"
|
|
|
|
"github.com/easyai/easyai-ai-gateway/apps/api/internal/auth"
|
|
"github.com/easyai/easyai-ai-gateway/apps/api/internal/clients"
|
|
"github.com/easyai/easyai-ai-gateway/apps/api/internal/runner"
|
|
"github.com/easyai/easyai-ai-gateway/apps/api/internal/store"
|
|
)
|
|
|
|
const volcesContentsCompatibilityMarker = "volces_contents_generations_v3"
|
|
|
|
// createVolcesContentsGenerationTask godoc
|
|
// @Summary 创建火山内容生成任务
|
|
// @Description 统一公开入口兼容火山方舟内容生成任务。网关 task id 是查询与取消用的公开 id；上游 id 另以 upstream_task_id 保留。
|
|
// @Tags volces-compatible
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security BearerAuth
|
|
// @Success 200 {object} VolcesContentsGenerationTaskResponse
|
|
// @Failure 400 {object} VolcesErrorEnvelope
|
|
// @Failure 401 {object} VolcesErrorEnvelope
|
|
// @Failure 429 {object} VolcesErrorEnvelope
|
|
// @Failure 502 {object} VolcesErrorEnvelope
|
|
// @Router /api/v1/contents/generations/tasks [post]
|
|
func (s *Server) createVolcesContentsGenerationTask(w http.ResponseWriter, r *http.Request) {
|
|
user, ok := auth.UserFromContext(r.Context())
|
|
if !ok || user == nil {
|
|
writeVolcesError(w, http.StatusUnauthorized, "unauthorized", "unauthorized")
|
|
return
|
|
}
|
|
body, err := s.decodeTaskRequestBody(r.Context(), w, r, "videos.generations")
|
|
if err != nil {
|
|
writeVolcesError(w, http.StatusBadRequest, err.Error(), clients.ErrorCode(err))
|
|
return
|
|
}
|
|
task, err := s.createVolcesCompatibleTask(r, user, body)
|
|
if err != nil {
|
|
writeVolcesCompatibleTaskError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, volcesCompatibleCreateResponse(task))
|
|
}
|
|
|
|
// getVolcesContentsGenerationTask godoc
|
|
// @Summary 查询火山内容生成任务
|
|
// @Tags volces-compatible
|
|
// @Produce json
|
|
// @Security BearerAuth
|
|
// @Param taskID path string true "任务 ID"
|
|
// @Success 200 {object} VolcesContentsGenerationTaskResponse
|
|
// @Failure 404 {object} VolcesErrorEnvelope
|
|
// @Router /api/v1/contents/generations/tasks/{taskID} [get]
|
|
func (s *Server) getVolcesContentsGenerationTask(w http.ResponseWriter, r *http.Request) {
|
|
task, ok := s.volcesCompatibleTaskForUser(w, r)
|
|
if !ok {
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, volcesCompatibleTask(task))
|
|
}
|
|
|
|
// listVolcesContentsGenerationTasks godoc
|
|
// @Summary 列出火山内容生成任务
|
|
// @Tags volces-compatible
|
|
// @Produce json
|
|
// @Security BearerAuth
|
|
// @Success 200 {object} map[string]any
|
|
// @Failure 400 {object} VolcesErrorEnvelope
|
|
// @Failure 401 {object} VolcesErrorEnvelope
|
|
// @Router /api/v1/contents/generations/tasks [get]
|
|
func (s *Server) listVolcesContentsGenerationTasks(w http.ResponseWriter, r *http.Request) {
|
|
user, ok := auth.UserFromContext(r.Context())
|
|
if !ok || user == nil {
|
|
writeVolcesError(w, http.StatusUnauthorized, "unauthorized", "unauthorized")
|
|
return
|
|
}
|
|
page := portraitAssetQueryInt(r, "page_num", "pageNumber", "page")
|
|
pageSize := portraitAssetQueryInt(r, "page_size", "pageSize")
|
|
tasks, err := s.store.ListVolcesCompatibleTasks(r.Context(), user, store.VolcesCompatibleTaskListFilter{
|
|
CompatibilityMarker: volcesContentsCompatibilityMarker,
|
|
Status: r.URL.Query().Get("filter.status"),
|
|
Model: r.URL.Query().Get("filter.model"),
|
|
TaskIDs: r.URL.Query()["filter.task_ids"],
|
|
Page: page,
|
|
PageSize: pageSize,
|
|
})
|
|
if err != nil {
|
|
s.logger.Error("list Volces-compatible tasks failed", "error", err)
|
|
writeVolcesError(w, http.StatusInternalServerError, "list tasks failed", "internal_error")
|
|
return
|
|
}
|
|
items := make([]any, 0)
|
|
for _, task := range tasks.Items {
|
|
items = append(items, volcesCompatibleTask(task))
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{
|
|
"items": items, "total": tasks.Total,
|
|
"page_num": tasks.Page, "page_size": tasks.PageSize,
|
|
})
|
|
}
|
|
|
|
// deleteVolcesContentsGenerationTask godoc
|
|
// @Summary 取消火山内容生成任务
|
|
// @Description 取消网关任务；对于已提交且保存了上游任务标识的 Volces 视频任务，同时调用火山 DELETE 接口并持久化取消状态。
|
|
// @Tags volces-compatible
|
|
// @Produce json
|
|
// @Security BearerAuth
|
|
// @Param taskID path string true "任务 ID"
|
|
// @Success 200 {object} VolcesContentsGenerationTaskResponse
|
|
// @Failure 404 {object} VolcesErrorEnvelope
|
|
// @Router /api/v1/contents/generations/tasks/{taskID} [delete]
|
|
func (s *Server) deleteVolcesContentsGenerationTask(w http.ResponseWriter, r *http.Request) {
|
|
task, ok := s.volcesCompatibleTaskForUser(w, r)
|
|
if !ok {
|
|
return
|
|
}
|
|
user, _ := auth.UserFromContext(r.Context())
|
|
result, err := s.runner.CancelVolcesVideoTask(r.Context(), task, user)
|
|
if err != nil {
|
|
if errors.Is(err, runner.ErrTaskAccessDenied) {
|
|
writeVolcesError(w, http.StatusNotFound, "task not found", "not_found")
|
|
return
|
|
}
|
|
s.logger.Error("cancel Volces-compatible task failed", "error", err)
|
|
writeVolcesError(w, http.StatusInternalServerError, "cancel task failed", "internal_error")
|
|
return
|
|
}
|
|
updated, err := s.store.GetTask(r.Context(), task.ID)
|
|
if err != nil {
|
|
writeVolcesError(w, http.StatusInternalServerError, "get cancelled task failed", "internal_error")
|
|
return
|
|
}
|
|
_ = result
|
|
writeJSON(w, http.StatusOK, volcesCompatibleTask(updated))
|
|
}
|
|
|
|
// createLegacyVolcesVideoGeneration godoc
|
|
// @Summary 创建 server-main 兼容视频任务
|
|
// @Description 兼容 server-main 的 /api/v1/video/generations，返回 submitted 和 task_id；额外保留火山任务字段。
|
|
// @Tags volces-compatible
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Security BearerAuth
|
|
// @Success 200 {object} map[string]any
|
|
// @Router /api/v1/video/generations [post]
|
|
func (s *Server) createLegacyVolcesVideoGeneration(w http.ResponseWriter, r *http.Request) {
|
|
user, ok := auth.UserFromContext(r.Context())
|
|
if !ok || user == nil {
|
|
writeError(w, http.StatusUnauthorized, "unauthorized")
|
|
return
|
|
}
|
|
body, err := s.decodeTaskRequestBody(r.Context(), w, r, "videos.generations")
|
|
if err != nil {
|
|
writeError(w, http.StatusBadRequest, err.Error(), clients.ErrorCode(err))
|
|
return
|
|
}
|
|
task, err := s.createVolcesCompatibleTask(r, user, body)
|
|
if err != nil {
|
|
writeVolcesCompatibleTaskError(w, err)
|
|
return
|
|
}
|
|
response := volcesCompatibleTask(task)
|
|
response["status"] = "submitted"
|
|
response["task_id"] = task.ID
|
|
writeJSON(w, http.StatusOK, response)
|
|
}
|
|
|
|
// getLegacyVolcesVideoResult godoc
|
|
// @Summary 查询 server-main 兼容视频结果
|
|
// @Tags volces-compatible
|
|
// @Produce json
|
|
// @Security BearerAuth
|
|
// @Param taskID path string true "任务 ID"
|
|
// @Success 200 {object} map[string]any
|
|
// @Router /api/v1/ai/result/{taskID} [get]
|
|
func (s *Server) getLegacyVolcesVideoResult(w http.ResponseWriter, r *http.Request) {
|
|
task, ok := s.volcesCompatibleTaskForUser(w, r)
|
|
if !ok {
|
|
return
|
|
}
|
|
compat := volcesCompatibleTask(task)
|
|
legacyStatus := "process"
|
|
switch compat["status"] {
|
|
case "succeeded":
|
|
legacyStatus = "success"
|
|
case "failed", "cancelled":
|
|
legacyStatus = "failed"
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{
|
|
"status": legacyStatus, "task_id": task.ID, "data": compat["content"], "result": compat,
|
|
})
|
|
}
|
|
|
|
func (s *Server) createVolcesCompatibleTask(r *http.Request, user *auth.User, body map[string]any) (store.GatewayTask, error) {
|
|
model := strings.TrimSpace(volcesCompatString(body["model"]))
|
|
if model == "" {
|
|
return store.GatewayTask{}, &clients.ClientError{Code: "invalid_parameter", Message: "model is required", StatusCode: http.StatusBadRequest, Retryable: false}
|
|
}
|
|
if !apiKeyScopeAllowed(user, "videos.generations") {
|
|
return store.GatewayTask{}, &clients.ClientError{Code: "forbidden", Message: "api key scope does not allow video generation", StatusCode: http.StatusForbidden, Retryable: false}
|
|
}
|
|
body["_gateway_compatibility"] = volcesContentsCompatibilityMarker
|
|
body["_gateway_target_protocol"] = clients.ProtocolVolcesContents
|
|
task, err := s.prepareAndCreateGatewayTask(r.Context(), r, user, "videos.generations", model, body, true)
|
|
if err != nil {
|
|
return store.GatewayTask{}, err
|
|
}
|
|
if err := s.store.SetTaskCompatibilitySubmission(r.Context(), task.ID, store.CompatibilitySubmission{
|
|
TargetProtocol: clients.ProtocolVolcesContents,
|
|
PublicID: task.ID,
|
|
}); err != nil {
|
|
return store.GatewayTask{}, err
|
|
}
|
|
task.CompatibilityProtocol = clients.ProtocolVolcesContents
|
|
task.CompatibilityPublicID = task.ID
|
|
if err := s.runner.EnqueueAsyncTask(r.Context(), task); err != nil {
|
|
return store.GatewayTask{}, &clients.ClientError{Code: "enqueue_failed", Message: err.Error(), StatusCode: http.StatusServiceUnavailable, Retryable: true}
|
|
}
|
|
return s.waitForCompatibilitySubmission(r, task)
|
|
}
|
|
|
|
func (s *Server) waitForCompatibilitySubmission(r *http.Request, task store.GatewayTask) (store.GatewayTask, error) {
|
|
deadline := time.NewTimer(30 * time.Second)
|
|
defer deadline.Stop()
|
|
ticker := time.NewTicker(25 * time.Millisecond)
|
|
defer ticker.Stop()
|
|
for {
|
|
current, err := s.store.GetTask(r.Context(), task.ID)
|
|
if err != nil {
|
|
return store.GatewayTask{}, err
|
|
}
|
|
if current.RemoteTaskID != "" || current.Status == "succeeded" {
|
|
return current, nil
|
|
}
|
|
if current.Status == "failed" || current.Status == "cancelled" {
|
|
status := http.StatusBadGateway
|
|
switch current.ErrorCode {
|
|
case "bad_request", "invalid_parameter", "unsupported_kind", "unsupported_model", "missing_credentials":
|
|
status = http.StatusBadRequest
|
|
case "permission_denied", "forbidden":
|
|
status = http.StatusForbidden
|
|
case "rate_limit":
|
|
status = http.StatusTooManyRequests
|
|
}
|
|
return store.GatewayTask{}, &clients.ClientError{
|
|
Code: firstNonEmpty(current.ErrorCode, current.Status),
|
|
Message: firstNonEmpty(current.ErrorMessage, current.Error, current.Message),
|
|
StatusCode: status,
|
|
Retryable: false,
|
|
Wire: compatibilitySubmissionWire(current),
|
|
}
|
|
}
|
|
select {
|
|
case <-r.Context().Done():
|
|
return store.GatewayTask{}, r.Context().Err()
|
|
case <-deadline.C:
|
|
return store.GatewayTask{}, &clients.ClientError{Code: "submission_timeout", Message: "upstream did not confirm task submission before timeout", StatusCode: http.StatusGatewayTimeout, Retryable: true}
|
|
case <-ticker.C:
|
|
}
|
|
}
|
|
}
|
|
|
|
func compatibilitySubmissionWire(task store.GatewayTask) *clients.WireResponse {
|
|
if task.CompatibilitySubmitHTTPStatus == 0 || strings.TrimSpace(task.CompatibilitySourceProtocol) == "" {
|
|
return nil
|
|
}
|
|
headers := map[string][]string{}
|
|
for name, value := range task.CompatibilitySubmitHeaders {
|
|
switch typed := value.(type) {
|
|
case []any:
|
|
for _, item := range typed {
|
|
if text := strings.TrimSpace(volcesCompatString(item)); text != "" {
|
|
headers[name] = append(headers[name], text)
|
|
}
|
|
}
|
|
case []string:
|
|
headers[name] = append([]string(nil), typed...)
|
|
case string:
|
|
headers[name] = []string{typed}
|
|
}
|
|
}
|
|
return &clients.WireResponse{
|
|
Protocol: task.CompatibilitySourceProtocol,
|
|
StatusCode: task.CompatibilitySubmitHTTPStatus,
|
|
Headers: headers,
|
|
Body: cloneVolcesCompatibleMap(task.CompatibilitySubmitBody),
|
|
Converted: task.CompatibilitySourceProtocol != task.CompatibilityProtocol,
|
|
}
|
|
}
|
|
|
|
func (s *Server) volcesCompatibleTaskForUser(w http.ResponseWriter, r *http.Request) (store.GatewayTask, bool) {
|
|
user, ok := auth.UserFromContext(r.Context())
|
|
if !ok || user == nil {
|
|
writeVolcesError(w, http.StatusUnauthorized, "unauthorized", "unauthorized")
|
|
return store.GatewayTask{}, false
|
|
}
|
|
task, err := s.store.GetVolcesCompatibleTask(r.Context(), user, volcesContentsCompatibilityMarker, strings.TrimSpace(r.PathValue("taskID")))
|
|
if err != nil {
|
|
if store.IsNotFound(err) {
|
|
writeVolcesError(w, http.StatusNotFound, "task not found", "not_found")
|
|
return store.GatewayTask{}, false
|
|
}
|
|
s.logger.Error("get Volces-compatible task failed", "error", err)
|
|
writeVolcesError(w, http.StatusInternalServerError, "get task failed", "internal_error")
|
|
return store.GatewayTask{}, false
|
|
}
|
|
if !isVolcesCompatibleTask(task) || !kelingCompatTaskOwnedBy(task, user) {
|
|
writeVolcesError(w, http.StatusNotFound, "task not found", "not_found")
|
|
return store.GatewayTask{}, false
|
|
}
|
|
return task, true
|
|
}
|
|
|
|
func isVolcesCompatibleTask(task store.GatewayTask) bool {
|
|
return task.Kind == "videos.generations" && strings.TrimSpace(volcesCompatString(task.Request["_gateway_compatibility"])) == volcesContentsCompatibilityMarker
|
|
}
|
|
|
|
func volcesCompatibleTask(task store.GatewayTask) map[string]any {
|
|
if volcesTaskUsesNativeProtocol(task) {
|
|
if raw := cloneVolcesCompatibleMap(mapFromVolcesCompat(task.Result["raw"])); len(raw) > 0 {
|
|
return raw
|
|
}
|
|
if raw := cloneVolcesCompatibleMap(task.RemoteTaskPayload); len(raw) > 0 {
|
|
return raw
|
|
}
|
|
}
|
|
response := map[string]any{}
|
|
response["id"] = volcesCompatiblePublicID(task)
|
|
response["model"] = firstNonEmpty(volcesCompatString(response["model"]), task.Model)
|
|
response["status"] = volcesCompatibleTaskStatus(task.Status)
|
|
response["created_at"] = task.CreatedAt.Unix()
|
|
response["updated_at"] = task.UpdatedAt.Unix()
|
|
for _, key := range []string{"content", "seed", "resolution", "ratio", "duration", "frames", "framespersecond"} {
|
|
if response[key] == nil && task.Request[key] != nil {
|
|
response[key] = task.Request[key]
|
|
}
|
|
}
|
|
if len(task.Usage) > 0 && response["usage"] == nil {
|
|
response["usage"] = task.Usage
|
|
}
|
|
if task.Status == "failed" || task.Status == "cancelled" {
|
|
response["error"] = map[string]any{"code": firstNonEmpty(task.ErrorCode, strings.ToUpper(task.Status)), "message": firstNonEmpty(task.ErrorMessage, task.Error, task.Message)}
|
|
}
|
|
return response
|
|
}
|
|
|
|
func volcesCompatibleCreateResponse(task store.GatewayTask) map[string]any {
|
|
if volcesTaskUsesNativeProtocol(task) {
|
|
if raw := cloneVolcesCompatibleMap(task.RemoteTaskPayload); len(raw) > 0 {
|
|
return raw
|
|
}
|
|
}
|
|
return map[string]any{"id": volcesCompatiblePublicID(task)}
|
|
}
|
|
|
|
func volcesCompatiblePublicID(task store.GatewayTask) string {
|
|
if strings.TrimSpace(task.CompatibilityPublicID) != "" {
|
|
return strings.TrimSpace(task.CompatibilityPublicID)
|
|
}
|
|
if volcesTaskUsesNativeProtocol(task) && strings.TrimSpace(task.RemoteTaskID) != "" {
|
|
return strings.TrimSpace(task.RemoteTaskID)
|
|
}
|
|
return task.ID
|
|
}
|
|
|
|
func volcesTaskUsesNativeProtocol(task store.GatewayTask) bool {
|
|
if strings.TrimSpace(task.CompatibilitySourceProtocol) != "" {
|
|
return task.CompatibilitySourceProtocol == clients.ProtocolVolcesContents && task.CompatibilityProtocol == clients.ProtocolVolcesContents
|
|
}
|
|
for index := len(task.Attempts) - 1; index >= 0; index-- {
|
|
if provider := strings.ToLower(strings.TrimSpace(task.Attempts[index].Provider)); provider != "" {
|
|
return provider == "volces"
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
func mapFromVolcesCompat(value any) map[string]any {
|
|
result, _ := value.(map[string]any)
|
|
return result
|
|
}
|
|
|
|
func volcesCompatibleTaskStatus(status string) string {
|
|
switch strings.ToLower(strings.TrimSpace(status)) {
|
|
case "succeeded", "success", "completed":
|
|
return "succeeded"
|
|
case "failed":
|
|
return "failed"
|
|
case "cancelled", "canceled":
|
|
return "cancelled"
|
|
case "running", "processing":
|
|
return "running"
|
|
default:
|
|
return "queued"
|
|
}
|
|
}
|
|
|
|
func cloneVolcesCompatibleMap(source map[string]any) map[string]any {
|
|
if len(source) == 0 {
|
|
return nil
|
|
}
|
|
raw, err := json.Marshal(source)
|
|
if err != nil {
|
|
return map[string]any{}
|
|
}
|
|
var out map[string]any
|
|
if err := json.Unmarshal(raw, &out); err != nil {
|
|
return map[string]any{}
|
|
}
|
|
return out
|
|
}
|
|
|
|
func writeVolcesCompatibleTaskError(w http.ResponseWriter, err error) {
|
|
status := http.StatusInternalServerError
|
|
var staged *gatewayTaskCreationError
|
|
if errors.As(err, &staged) {
|
|
err = staged.Err
|
|
}
|
|
var clientErr *clients.ClientError
|
|
if errors.As(err, &clientErr) && clientErr.StatusCode > 0 {
|
|
status = clientErr.StatusCode
|
|
} else if errors.As(err, &clientErr) {
|
|
status = http.StatusBadRequest
|
|
}
|
|
if wire := clients.ErrorWireResponse(err); wireResponseMatches(wire, clients.ProtocolVolcesContents) {
|
|
writeWireResponse(w, wire)
|
|
return
|
|
}
|
|
writeVolcesError(w, status, err.Error(), clients.ErrorCode(err))
|
|
}
|
|
|
|
func volcesCompatString(value any) string {
|
|
switch typed := value.(type) {
|
|
case string:
|
|
return strings.TrimSpace(typed)
|
|
case json.Number:
|
|
return typed.String()
|
|
case float64:
|
|
return strconv.FormatFloat(typed, 'f', -1, 64)
|
|
default:
|
|
return ""
|
|
}
|
|
}
|