1

server-rs/crates/shared-contracts/src/assets.rs

@@ -663,7 +663,7 @@ mod tests {
         let payload = serde_json::to_value(CreateDirectUploadTicketResponse {
             upload: DirectUploadTicketPayload {
                 signature_version: "v4".to_string(),
-                provider: "aliyun-oss",
+                provider: "aliyun-oss".to_string(),
                 bucket: "genarrative-assets".to_string(),
                 endpoint: "oss-cn-shanghai.aliyuncs.com".to_string(),
                 host: "https://genarrative-assets.oss-cn-shanghai.aliyuncs.com".to_string(),

server-rs/crates/shared-contracts/src/creation_audio.rs

@@ -0,0 +1,128 @@
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "snake_case")]
+pub enum CreationAudioGenerationKind {
+    BackgroundMusic,
+    SoundEffect,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct CreationAudioAsset {
+    pub task_id: String,
+    pub provider: String,
+    #[serde(default)]
+    pub asset_object_id: Option<String>,
+    #[serde(default)]
+    pub asset_kind: Option<String>,
+    pub audio_src: String,
+    #[serde(default)]
+    pub prompt: Option<String>,
+    #[serde(default)]
+    pub title: Option<String>,
+    #[serde(default)]
+    pub updated_at: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct CreateBackgroundMusicRequest {
+    pub prompt: String,
+    pub title: String,
+    #[serde(default)]
+    pub tags: Option<String>,
+    #[serde(default)]
+    pub model: Option<String>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct CreateSoundEffectRequest {
+    pub prompt: String,
+    #[serde(default)]
+    pub duration: Option<u8>,
+    #[serde(default)]
+    pub seed: Option<u64>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct AudioGenerationTaskResponse {
+    pub kind: CreationAudioGenerationKind,
+    pub task_id: String,
+    pub provider: String,
+    pub status: String,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "snake_case")]
+pub enum CreationAudioStoragePrefix {
+    PuzzleAssets,
+    #[serde(rename = "match3d_assets")]
+    Match3DAssets,
+    CustomWorldScenes,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct PublishGeneratedAudioAssetRequest {
+    pub entity_kind: String,
+    pub entity_id: String,
+    pub slot: String,
+    pub asset_kind: String,
+    #[serde(default)]
+    pub profile_id: Option<String>,
+    #[serde(default)]
+    pub storage_prefix: Option<CreationAudioStoragePrefix>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "camelCase")]
+pub struct GeneratedAudioAssetResponse {
+    pub kind: CreationAudioGenerationKind,
+    pub task_id: String,
+    pub provider: String,
+    pub status: String,
+    #[serde(default)]
+    pub asset_object_id: Option<String>,
+    #[serde(default)]
+    pub asset_kind: Option<String>,
+    #[serde(default)]
+    pub audio_src: Option<String>,
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde_json::json;
+
+    #[test]
+    fn creation_audio_contracts_use_camel_case_fields() {
+        let request = PublishGeneratedAudioAssetRequest {
+            entity_kind: "match3d_item".to_string(),
+            entity_id: "match3d-item-1".to_string(),
+            slot: "click_sound".to_string(),
+            asset_kind: "match3d_click_sound".to_string(),
+            profile_id: Some("profile-1".to_string()),
+            storage_prefix: Some(CreationAudioStoragePrefix::Match3DAssets),
+        };
+        let payload = serde_json::to_value(request).expect("request should serialize");
+        assert_eq!(payload["entityKind"], json!("match3d_item"));
+        assert_eq!(payload["storagePrefix"], json!("match3d_assets"));
+
+        let asset = CreationAudioAsset {
+            task_id: "task-1".to_string(),
+            provider: "vector-engine-suno".to_string(),
+            asset_object_id: Some("assetobj_1".to_string()),
+            asset_kind: Some("puzzle_background_music".to_string()),
+            audio_src: "/generated-puzzle-assets/a.mp3".to_string(),
+            prompt: Some("轻快音乐".to_string()),
+            title: Some("拼图音乐".to_string()),
+            updated_at: Some("2026-05-11T00:00:00Z".to_string()),
+        };
+        let payload = serde_json::to_value(asset).expect("asset should serialize");
+        assert_eq!(payload["taskId"], json!("task-1"));
+        assert_eq!(payload["audioSrc"], json!("/generated-puzzle-assets/a.mp3"));
+    }
+}

server-rs/crates/shared-contracts/src/lib.rs

@@ -6,6 +6,7 @@ pub mod auth;
 pub mod big_fish;
 pub mod big_fish_works;
 pub mod creation_agent_document_input;
+pub mod creation_audio;
 pub mod creation_entry_config;
 pub mod creative_agent;
 pub mod hyper3d;

server-rs/crates/shared-contracts/src/match3d_agent.rs

@@ -1,5 +1,7 @@
 use serde::{Deserialize, Serialize};
 
+use crate::creation_audio::CreationAudioAsset;
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct CreateMatch3DAgentSessionRequest {
@@ -108,6 +110,10 @@ pub struct Match3DGeneratedItemAssetResponse {
     pub task_uuid: Option<String>,
     #[serde(default)]
     pub subscription_key: Option<String>,
+    #[serde(default)]
+    pub background_music: Option<CreationAudioAsset>,
+    #[serde(default)]
+    pub click_sound: Option<CreationAudioAsset>,
     pub status: String,
     #[serde(default)]
     pub error: Option<String>,

server-rs/crates/shared-contracts/src/match3d_works.rs

@@ -1,5 +1,7 @@
 use serde::{Deserialize, Serialize};
 
+use crate::creation_audio::CreationAudioAsset;
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct PutMatch3DWorkRequest {
@@ -16,6 +18,12 @@ pub struct PutMatch3DWorkRequest {
     pub difficulty: u32,
 }
 
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub struct PutMatch3DAudioAssetsRequest {
+    pub generated_item_assets: Vec<Match3DGeneratedItemAssetResponse>,
+}
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct Match3DWorkSummaryResponse {
@@ -63,6 +71,10 @@ pub struct Match3DGeneratedItemAssetResponse {
     pub task_uuid: Option<String>,
     #[serde(default)]
     pub subscription_key: Option<String>,
+    #[serde(default)]
+    pub background_music: Option<CreationAudioAsset>,
+    #[serde(default)]
+    pub click_sound: Option<CreationAudioAsset>,
     pub status: String,
     #[serde(default)]
     pub error: Option<String>,

server-rs/crates/shared-contracts/src/puzzle_agent.rs

@@ -1,5 +1,7 @@
 use serde::{Deserialize, Serialize};
 
+use crate::creation_audio::CreationAudioAsset;
+
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct CreatePuzzleAgentSessionRequest {
@@ -151,6 +153,8 @@ pub struct PuzzleDraftLevelResponse {
     pub picture_description: String,
     #[serde(default)]
     pub picture_reference: Option<String>,
+    #[serde(default)]
+    pub background_music: Option<CreationAudioAsset>,
     pub candidates: Vec<PuzzleGeneratedImageCandidateResponse>,
     #[serde(default)]
     pub selected_candidate_id: Option<String>,