isabella232 / coconutpy

Python client Library for encoding Videos with Coconut

Python client Library for encoding Videos with Coconut

Install

sudo easy_install coconutpy

Submitting the job

Use the API Request Builder to generate a config file that match your specific workflow.

Example of coconut.conf:

var s3 = s3://accesskey:secretkey@mybucket

set webhook = http://mysite.com/webhook/coconut?videoId=$vid

-> mp4  = $s3/videos/$vid.mp4
-> webm = $s3/videos/$vid.webm
-> jpg:300x = $s3/previews/thumbs_#num#.jpg, number=3

Here is the python code to submit the config file:

import coconut
from coconut import job

job = coconut.job.create(
  api_key='k-api-key',
  conf='coconut.conf',
  source='http://yoursite.com/media/video.mp4',
  vars={'vid': 1234}
)

if job['status'] == 'ok':
  print job['id']
else:
  print job['error_code']
  print job['error_message']

You can also create a job without a config file. To do that you will need to give every settings in the method parameters. Here is the exact same job but without a config file:

vid = 1234
s3 = 's3://accesskey:secretkey@mybucket'

job = coconut.job.create(
  api_key='k-api-key',
  source='http://yoursite.com/media/video.mp4',
  webhook='http://mysite.com/webhook/coconut?videoId=' + str(vid),
  outputs={
    'mp4': s3 + '/videos/video_' + str(vid) + '.mp4',
    'webm': s3 + '/videos/video_' + str(vid) + '.webm',
    'jpg:300x': s3 + '/previews/thumbs_#num#.jpg, number=3'
  }
)

Other example usage:

# Getting info about a job
job = coconut.job.get(18370773);

# Retrieving metadata
coconut.job.get_all_metadata(18370773);

# Retrieving the source file metadata only
coconut.job.get_metadata_for(18370773, 'source');

Note that you can use the environment variable COCONUT_API_KEY to set your API key.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Released under the MIT license.

---

• Coconut website: http://coconut.co
• API documentation: http://coconut.co/docs
• Contact: [email protected]
• Twitter: @OpenCoconut