diff --git a/crates/api_clients/seedance2pro_client/src/error/seedance2pro_generic_api_error.rs b/crates/api_clients/seedance2pro_client/src/error/seedance2pro_generic_api_error.rs
index 6b7572e327..d0a7d1f6f8 100644
--- a/crates/api_clients/seedance2pro_client/src/error/seedance2pro_generic_api_error.rs
+++ b/crates/api_clients/seedance2pro_client/src/error/seedance2pro_generic_api_error.rs
@@ -16,8 +16,12 @@ pub enum Seedance2ProGenericApiError {
   /// Includes the original body.
   SerdeParseErrorWithBodyOnNon200(serde_json::Error, String),
 
-  /// An uncategorized bad HTTP response.
-  UncategorizedBadResponse(String),
+  /// A response that parsed, but didn't have the shape we expected
+  /// (eg. an empty batch response array).
+  UnexpectedResponseShape {
+    explanation: String,
+    raw_body: String,
+  },
 
   /// An uncategorized bad HTTP response with status code and body.
   UncategorizedBadResponseWithStatusAndBody {
@@ -37,7 +41,7 @@ impl Display for Seedance2ProGenericApiError {
       Self::CloudflareError(err) => write!(f, "Cloudflare error: {}", err),
       Self::SerdeResponseParseErrorWithBody(err, body) => write!(f, "Failed to parse response body: {:?}. Body: {}", err, body),
       Self::SerdeParseErrorWithBodyOnNon200(err, body) => write!(f, "Failed to parse non-200 response body: {:?}. Body: {}", err, body),
-      Self::UncategorizedBadResponse(msg) => write!(f, "Uncategorized bad response: {}", msg),
+      Self::UnexpectedResponseShape { explanation, raw_body } => write!(f, "Unexpected response shape: {}. Body: {}", explanation, raw_body),
       Self::UncategorizedBadResponseWithStatusAndBody { status_code, body } => write!(f, "Uncategorized bad response: status code {}, body: {}", status_code, body),
       Self::WreqError(err) => write!(f, "Wreq client error: {}", err),
     }
diff --git a/crates/api_clients/seedance2pro_client/src/requests/generate_character/generate_character.rs b/crates/api_clients/seedance2pro_client/src/requests/generate_character/generate_character.rs
index 3bc1f8c812..755aa578b6 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/generate_character/generate_character.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/generate_character/generate_character.rs
@@ -119,9 +119,10 @@ pub async fn generate_character(args: GenerateCharacterArgs<'_>) -> Result<Gener
   let data = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/generate_image/generate_image.rs b/crates/api_clients/seedance2pro_client/src/requests/generate_image/generate_image.rs
index f45abb38fe..1347bde5a5 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/generate_image/generate_image.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/generate_image/generate_image.rs
@@ -285,9 +285,10 @@ pub async fn generate_image(args: GenerateImageArgs<'_>) -> Result<GenerateImage
   let task_data = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/generate_video/generate_video.rs b/crates/api_clients/seedance2pro_client/src/requests/generate_video/generate_video.rs
index 0ea61fd04c..eff36d109f 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/generate_video/generate_video.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/generate_video/generate_video.rs
@@ -403,9 +403,10 @@ pub async fn generate_video(args: GenerateVideoArgs<'_>) -> Result<GenerateVideo
   let task_data = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/get_user_auth_details/get_user_auth_details.rs b/crates/api_clients/seedance2pro_client/src/requests/get_user_auth_details/get_user_auth_details.rs
index 8b970b1432..91d1925d4c 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/get_user_auth_details/get_user_auth_details.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/get_user_auth_details/get_user_auth_details.rs
@@ -94,9 +94,10 @@ pub async fn get_user_auth_details(
   let json = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/poll_characters/poll_characters.rs b/crates/api_clients/seedance2pro_client/src/requests/poll_characters/poll_characters.rs
index 96c45d702e..da35e2f849 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/poll_characters/poll_characters.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/poll_characters/poll_characters.rs
@@ -181,9 +181,10 @@ pub async fn poll_characters(args: PollCharactersArgs<'_>) -> Result<PollCharact
   let data = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/poll_orders/poll_orders.rs b/crates/api_clients/seedance2pro_client/src/requests/poll_orders/poll_orders.rs
index fab591b663..fd0b0ea0e2 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/poll_orders/poll_orders.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/poll_orders/poll_orders.rs
@@ -201,9 +201,10 @@ pub async fn poll_orders(args: PollOrdersArgs<'_>) -> Result<PollOrdersResponse,
   let json = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/prepare_file_upload/prepare_file_upload.rs b/crates/api_clients/seedance2pro_client/src/requests/prepare_file_upload/prepare_file_upload.rs
index 7bd5a54dfd..13fd98fe60 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/prepare_file_upload/prepare_file_upload.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/prepare_file_upload/prepare_file_upload.rs
@@ -106,9 +106,10 @@ pub async fn prepare_file_upload(args: PrepareFileUploadArgs<'_>) -> Result<Prep
   let upload_url = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/update_character/update_character.rs b/crates/api_clients/seedance2pro_client/src/requests/update_character/update_character.rs
index c9ca66b658..204f5fa91c 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/update_character/update_character.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/update_character/update_character.rs
@@ -102,9 +102,10 @@ pub async fn update_character(args: UpdateCharacterArgs<'_>) -> Result<UpdateCha
   let data = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;
diff --git a/crates/api_clients/seedance2pro_client/src/requests/workflow_run_task/workflow_run_task.rs b/crates/api_clients/seedance2pro_client/src/requests/workflow_run_task/workflow_run_task.rs
index 64bb61c74f..42d0a1e51c 100644
--- a/crates/api_clients/seedance2pro_client/src/requests/workflow_run_task/workflow_run_task.rs
+++ b/crates/api_clients/seedance2pro_client/src/requests/workflow_run_task/workflow_run_task.rs
@@ -415,9 +415,10 @@ pub async fn workflow_run_task(args: WorkflowRunTaskArgs<'_>) -> Result<Workflow
   let task_data = batch_response
     .into_iter()
     .next()
-    .ok_or_else(|| Seedance2ProGenericApiError::UncategorizedBadResponse(
-      "Empty batch response array".to_string()
-    ))?
+    .ok_or_else(|| Seedance2ProGenericApiError::UnexpectedResponseShape {
+      explanation: "Empty batch response array".to_string(),
+      raw_body: response_body.clone(),
+    })?
     .result
     .data
     .json;