wtgoku
531ffc6ee8
The server now keeps Vidu URL-based image2video requests on a valid default duration when callers omit duration, and it forwards MiniMax S2V reference images in the images[] shape expected by the deployed Hailuo adapter. Constraint: The test environment currently validates provider behavior through popiartServer binary deploys rather than waiting for broader upstream adapter rollouts Rejected: Keep the old shared 4-second default for all providers | breaks viduq3-turbo when duration is omitted Rejected: Translate S2V references into subject_reference in popiartServer | the deployed Hailuo adapter already expects top-level images and performs its own mapping Confidence: high Scope-risk: narrow Reversibility: clean Directive: Keep provider-specific video defaults and reference-shape compatibility isolated in popiartServer unless upstream adapters are upgraded in lockstep Tested: go test ./internal/server -run TestInferRouteKeyForModelRecognizesViduAsVideo|TestGenerate|TestResolve|TestSubmitMiniMaxVideoTask|TestSubmitImageToVideoTask|TestExecuteImageToImageJobUsesGenerationsPathForMiniMax|TestExecuteImageToVideoJob|TestResolveVideoReferencesSupportsImagesArray Not-tested: Full PopiNewAPI unit suite from the local checkout
popiartServer
Local development backend for popiartcli.
This is a thin single-server backend for local integration. It keeps the CLI
contract stable while pushing model-heavy responsibilities back to
PopiNewAPI.
It is meant to validate these product-facing APIs first:
authskillsrunjobsartifactsmedia- basic
budget,project, andmodelsstubs
Project Relationship
See docs/project-relationship.md.
Persistence details for the current local backend are documented in docs/persistence.md. Stable media URL behavior and rollout notes are documented in docs/stable-media-url-v1.md.
This note explains how popiartcli, popiartServer, and PopiNewAPI split responsibilities, and why routing, billing attribution, and provider access belong in the backend layers rather than the CLI.
Run
make run
Default address:
http://127.0.0.1:8080
Health check:
curl http://127.0.0.1:8080/health
Use it from popiartcli:
cd /Users/jiajia/popiartcli
go run ./cmd/popiart --endpoint http://127.0.0.1:8080/v1 auth login --key <your-popinewapi-key>
go run ./cmd/popiart --endpoint http://127.0.0.1:8080/v1 skills list
go run ./cmd/popiart --endpoint http://127.0.0.1:8080/v1 media upload ./source.png
go run ./cmd/popiart --endpoint http://127.0.0.1:8080/v1 artifacts upload ./source.png --role source
Optional skillhub source:
export POPIART_SKILLHUB_DIR=/tmp/Popiart_skillhub
In local development, /tmp/Popiart_skillhub is used automatically when it exists.
Notes
- Local persistence is intentionally thin:
sessions,job refs, and project route overrides live in SQLite. - The local backend now keeps a lightweight media store under
POPIART_DATA_DIR/media/and exposes stablemediaURLs for uploaded files and persisted job outputs. artifactmetadata is still derived fromresult_refs_json, but new artifacts bind to a localmedia_idand a stableurl.- New endpoints now include:
POST /v1/media/uploadGET /v1/media/:idGET /v1/media/:id/content
job logsare synthesized from job state transitions instead of being stored as a separate table.- The local development backend verifies your login key against the local
PopiNewAPI. - This server is a development backend, not the final production architecture.